Cache Entries Browser

The Entries module adds an Entries tab to your MilliCache settings screen. It turns the cache from a black box into a browsable table: every cached page is listed with its flags, size, HTTP status, and expiry, and you can search, filter, and delete entries individually.

Open it at Settings → MilliCache → Entries. On multisite, the Network Admin settings screen shows entries from all sites.

What You See#Copied!

Each row represents one cached page. Pages cached in multiple variants (for example, different buckets or gzip states sharing the same flags) are grouped into a single row with a variant count.

Column Meaning
Title Page title with a link to the URL and a freshness indicator
Site Origin site (network view on multisite only, click to filter)
URL The cached request URL
Type Singular, Archive, Home, Feed, or Other
Status HTTP status code of the cached response
Post Type Post type behind singular entries
Flags All cache flags on the entry, click a flag to filter by it
Cached When the entry was stored (relative time)
Expires Time until expiry, or the remaining grace period for stale entries
Gzip Whether the body is stored compressed
Size Stored size of the entry
Variants Number of variants sharing this flag set (opens the variant modal)

A summary bar above the table shows the total number of cached pages, the total cache size, the number of stale entries, and a distribution bar by post type. While a preload is running, the summary also shows live progress. The table refreshes automatically every 15 seconds while the tab is open.

Searching and Filtering#Copied!

The search field matches URLs and flags (with wildcard support, so you can search the same way you clear) and finds pages by title or content through WordPress search:

  • /pricing finds every entry whose URL contains /pricing
  • post:* finds all singular post entries
  • archive:* finds all archive entries
  • Hello World finds the cached pages of matching posts

Type, post type, gzip state, and (on multisite) site are available as column filters. Clicking any flag or the post-type distribution bar applies the matching filter directly.

Inspecting Variants#Copied!

When a page exists in more than one variant, the Variants count opens a modal listing each stored variant. The modal only shows the dimensions that actually differ between variants: cookies, unique request variables, buckets, request method, protocol, HTTP status, differing response headers, size, and gzip state. Each variant can be deleted individually.

This is the fastest way to answer "why is this page cached twice?": the differing column tells you which request dimension split the cache.

Deleting Entries#Copied!

Row actions let you:

  • Copy URL of the cached page
  • Delete a single entry (or a bulk selection)
  • Delete all variants of a page at once

Deleting from the Entries tab removes the entry immediately. For flag-based or site-wide clearing, use the regular cache clearing tools.

WP-CLI#Copied!

The module adds wp millicache entries, a read-only listing command with the same filters as the UI:

 1wp millicache entries [--search=<term>] [--flag=<pattern>] [--type=<type>]
 2                      [--post-type=<type>] [--status=<status>] [--gzip=<gzip>]
 3                      [--orderby=<field>] [--order=<order>]
 4                      [--fields=<fields>] [--format=<format>]

Options:

Option Description
--search=<term> Substring match on flags and URLs
--flag=<pattern> Wildcard flag pattern (e.g. post:*, *:post:*)
--type=<type> singular, home, archive, feed, or other
--post-type=<type> Post type slug
--status=<status> HTTP status code
--gzip=<gzip> yes or no
--orderby=<field> url, type, status, size, stored, ttl (default: stored)
--order=<order> asc or desc (default: desc)
--fields=<fields> Columns to show (default: url,flags,stored,ttl,size)
--format=<format> table, json, csv, yaml, count (default: table)

Available fields: hash, url, type, post_type, status, size, stored, ttl, grace, gzip, flags.

Examples:

 1# List all cached entries
 2wp millicache entries
 3
 4# All singular pages
 5wp millicache entries --type=singular --post-type=page
 6
 7# Everything tagged with a post flag
 8wp millicache entries --flag="post:*"
 9
10# Include grace period in the output
11wp millicache entries --fields=url,size,ttl,grace
12
13# Count entries
14wp millicache entries --format=count

To delete entries from the command line, use the standard wp millicache clear command.

Notes#Copied!

Note: Entries whose grace period has fully elapsed are hidden from the browser. They are unreachable ghosts awaiting eviction by the storage server and no longer count as cached pages.
Note: The entry index is cached for 30 seconds to keep the tab fast on large caches. Deletions refresh it immediately; a brand-new cache entry can take a few seconds to appear.

Next Steps#Copied!

Last updated: