| name | umbraco-published-cache |
| description | Published content cache operations |
| metadata | {"version":"0.4.8","requires":{"bins":["umbraco"],"skills":["umbraco-shared"]}} |
published-cache
PREREQUISITE: Read ../umbraco-shared/SKILL.md for auth, global flags, and security rules.
umbraco published-cache <command> [flags]
Read Commands
| Command | Description |
|---|
published-cache status | Get published cache rebuild status |
status
umbraco published-cache status
Mutation Commands
Safety: Always use --dry-run first. Remove the flag only after verifying the dry-run output.
| Command | Description |
|---|
published-cache rebuild | Rebuild the published content cache from the database |
published-cache reload | Reload the in-memory published cache |
rebuild
umbraco published-cache rebuild
POST /published-cache/rebuild. Rebuilds the published content cache from the database — the standard fix for stale published content. Expensive on large sites; with --wait, polls the rebuild status until isRebuilding clears or --timeout elapses (mirroring 'indexer rebuild --wait').
| Flag | Type | Default | Description |
|---|
--dry-run | bool | false | Print the planned request without executing |
--force | bool | false | Confirm the rebuild |
--poll-interval | duration | 1s | How often to poll when --wait is set |
--timeout | duration | 1m0s | How long to wait when --wait is set (e.g. 30s, 2m) |
--wait | bool | false | Poll the rebuild status after triggering until isRebuilding clears or --timeout elapses |
Safe pattern:
umbraco published-cache rebuild --dry-run
umbraco published-cache rebuild --force
reload
umbraco published-cache reload
POST /published-cache/reload. Reloads the in-memory published cache from the cache store without a database rebuild; much cheaper than 'published-cache rebuild'.
| Flag | Type | Default | Description |
|---|
--dry-run | bool | false | Print the planned request without executing |
Safe pattern:
umbraco published-cache reload --dry-run
umbraco published-cache reload
Discovering Commands
umbraco published-cache --help
umbraco schema published-cache.<method>