A snapshot saves Delta design, content and selected plugin data at one moment. Restore all of it or select the parts you need. Delta also saves snapshots before changes that are hard to undo.
What is in a snapshot
By default, a snapshot captures the site’s Delta state and the default-on data parts of every running integration. You can select fewer sections or plugin parts for a partial snapshot:
- The design system: tokens, notes,
site.css,components.css,site.jsand components - Site scripts, fonts and icons
- Templates, menus, terms and field maps
- Delta designs on entries, with the language and translations each entry names. A plain post with no Delta design is not in the snapshot.
- Skills and rules under Delta → Context
- Delta settings: guardrail and feature toggles and disabled abilities. Secrets are left out. A restore the agent starts leaves your guardrail and ability switches as they are; one you start applies the snapshot’s.
- WordPress site settings. The site URL, home URL and admin email are not restored.
Snapshots do not contain media files, users, plugin files, Memory entries or secrets. They never carry members, students, orders, subscriptions, progress, earned certificates, reviews, form submissions or coupon usage. Payment keys, bank accounts, API keys, tokens and licences stay out. Keep host backups for the files and records a snapshot does not carry.
The Snapshots screen
Plugin data is divided into parts. Some parts, such as payment settings, are off until you pick them. This includes SEO settings, robots rules and redirects; MemberPress payments and tax; LifterLMS coupons and payments; WooCommerce address, tax, shipping and payments; SchemaWP history; and Tutor LMS payment gateways and coupons. A snapshot also carries Yoast SEO settings and term SEO, LiteSpeed Cache settings, and Search & Filter queries, fields and settings. Ask the agent to list the available parts before you choose.
Go to Delta → Snapshots. The list under Saved snapshots shows every snapshot with its label, its date and where it came from: Saved by request, Before restore or Automatic. A pinned snapshot also shows Pinned.
- Save Snapshot saves a snapshot now. Give it a label in the Snapshot label field, for example the name of a design a client signed off.
- Restore puts the site back to that snapshot. Delta asks you to confirm first.
- Pin keeps a snapshot until you unpin it. Unpin lets Delta remove it again when the list is full.
- Delete removes a snapshot. A pinned snapshot cannot be deleted: unpin it first.
A row with a Partial badge holds only some items, and the badge names them. Restoring it puts back only those items. Other pages and templates stay as they are.
Automatic snapshots
Before an agent runs a plugin ability that changes data, Delta saves the relevant plugin data. This does not turn a partial snapshot into a full site backup.
Before the agent makes one of these changes, Delta saves a partial snapshot of the items the change touches:
- Replacing the content of a page or entry, or copying content from one entry to another
- Updating many entries at once
- Deleting templates, or removing display conditions from several templates
- Deleting a term
- Deleting a menu or a menu location
- Writing
site.cssorsite.js
Its label starts with Before delta/ and names the ability, for example Before delta/set-page-content. A dry run changes nothing, so it saves no snapshot.
Design token and notes changes do not save a snapshot on their own. Before a restyle, ask the agent to save one.
Delta also saves a full snapshot labelled Before site.css import before it makes an imported CSS file your live stylesheet, and a pinned Initial seed snapshot when it first sets up the design system.
A restore can be undone
Preview the saved parts before restoring. The agent can report parts that are ready, need a plugin, have an older plugin version or use an unknown format. Choose the Delta sections, integration parts or extras to restore. Other sections stay as they are.
Every restore first saves a full snapshot of the site as it is now, marked Before restore. This includes Restore Default on Delta → Design. To undo a restore, restore that snapshot.
How many are kept
Delta keeps three groups of unpinned snapshots, and removes the oldest in a group when it is full:
- 20 automatic snapshots
- 20 snapshots saved by request
- 5 before-restore snapshots
Pinned snapshots do not count toward these limits, and Delta never removes them. Pin a snapshot you want to keep, such as a signed-off design.
Asking the agent
“Save a snapshot called {label} before you restyle the site.”
“Show me the snapshots from today.”
“Restore the snapshot from before the header change.”
“Pin the snapshot called {label}.”
The agent confirms with you before it restores, because a restore replaces the live site’s design and content.
For developers
Registered extras use 21press_delta_snapshot_extras. Automatic.css registers acss-settings. Extras do not travel to another site. See Developer hooks.
Use delta/get-snapshot with id to inspect parts. Their restore statuses are restore, plugin_older, plugin_missing and format_unknown. On create and restore, integrations maps an integration ID to an array of part keys; an empty array selects all parts for that integration.
The snapshot abilities include delta/list-snapshots, delta/create-snapshot, delta/get-snapshot, delta/get-snapshot-job, delta/cancel-snapshot-job, delta/restore-snapshot, delta/restore-seed, delta/delete-snapshot, delta/pin-snapshot and delta/unpin-snapshot. Use delta/list-integration-data with an empty input object to read the running integrations, their part keys and registered extras.
Create, restore and restore-seed run as background jobs. Each returns a job, and the agent polls delta/get-snapshot-job until the job is complete or failed. A job reports lock while another step holds it, with the time another step may take over, and interrupted when a step ended its request. The next step carries on, and the job fails after three tries at the same point.
On delta/create-snapshot, set a label and optional reason, which defaults to manual. Use sections, integrations and extras to select scope. Omitting sections and integrations captures all Delta sections and running integrations’ default-on parts. postTypes limits the entries section on capture only. Requested snapshots can be partial.
On delta/restore-snapshot, pass the snapshot id. Omit sections, integrations and extras to restore everything it holds. An integrations-only request restores no Delta sections; a sections-only request restores no plugin data. Restoring access rules, robots rules or redirects waits for approval while the extra security layer is on. Native-only posts stay as they are.