Cache
Refresh the store cache fully or partially, run predefined purges, and process pending purge requests.
The Cache screen (page title Cache management) is where you partially or fully refresh the cache of your web store. The store caches data for products, categories, campaigns, and the homepage for speed; therefore, changes in the catalog, prices, or store settings only reflect on the storefront after the relevant cache is cleared. On this screen, you can clear the cache immediately, save frequently used purges for one-click execution, and monitor accumulated purge requests. Most of the operations here directly affect the live store; this screen is intended for administrators and e-commerce teams responsible for the technical operation of the store.
Accessing the screen
Navigate through the menu: Settings & Authorization › System › Cache. If you do not see it in the menu, your account does not have permission for this screen.
Screen sections
- Page title Cache management, with the description "Refresh the store cache partially or fully." below it; on the right, the Integration (Web) selector.
- If no integration is selected, a warning "Please select an integration first." appears below the title.
- Four tabs: Renewal, Predefined purges, Pending, and Custom purge.
The selected integration, tab, and search, filter, sorting, and pagination settings in lists are saved in the page URL; sharing the URL opens the same view. Changing tabs resets search, filters, grouping, and sorting.
Integration selection
The Integration (Web) list shows the web store integrations of your workspace (usually displayed by the store’s domain name). If you have multiple web stores, this selection determines which store the operation applies to. Without selecting an integration:
- Summary cards and the Prefixes section in the Renewal tab are hidden, and Full refresh buttons are disabled.
- The Clear and shortcut Run buttons in the Custom purge tab are disabled.
Each step in the Predefined purges and Custom cache purge forms has its own integration field; when adding a new step, this field defaults to the integration selected above.
Renewal tab
This is the default tab. When an integration is selected, four summary cards appear at the top:
| Card | Meaning |
|---|---|
| Pending messages | Number of cache purge requests not yet processed. |
| URL records | Number of URL records in the store. |
| Time window | The allowed time range for full refresh. Below it shows Window open or Window closed. |
| Full refresh allowed | If Yes, the "All …" buttons are enabled; if No, the card appears in warning color. |
Full refresh gate
This card contains three tags; if the condition is met, they appear green, otherwise gray:
- Owner admin: your account is an administrator exempt from time and threshold restrictions.
- Window open: you are currently within the allowed time range.
- Ratio unlocked: the number of pending changes has exceeded the threshold.
If full refresh is closed, the warning "Full refresh is currently closed: it can only be done during the specified time window, by the owner admin, or when the pending change threshold is exceeded." appears. Full refresh opens when any of these three conditions are met. The rule is also enforced on the server; the screen status only locks the buttons and shows the reason. Until integration data loads, the "All …" buttons remain disabled.
Full refresh
The Full refresh card has five buttons:
| Button | When usable |
|---|---|
| Homepage | Always if integration is selected. |
| Campaign | Always if integration is selected. |
| All products | Only when full refresh gate is open. |
| All categories | Only when full refresh gate is open. |
| Whole cache | Only when full refresh gate is open. |
- Select the integration at the top.
- Press the desired button.
- Read the confirmation checkbox message: "“…” will invalidate the live store cache and the effect will be immediate. Do you confirm?" and press Full refresh.
If the request is accepted, a notification "Operation received, cache purge added to queue." appears. If the server rejects the request, a notification "Operation rejected by server." and the reason appear. Full refresh is irreversible; use the "All …" buttons only when truly necessary.
Prefixes
When an integration is selected, the Prefixes card shows the saved prefix lists for Homepage and Campaign (shows "—" if none).
- Press the Edit button next to the row you want to change.
- In the opened Prefixes box, enter one prefix per line ("One prefix per line.").
- Press Save prefixes.
The saved list replaces the existing one; no confirmation is asked. If you save with the box empty, the list is cleared entirely. On success, a Saved notification appears. The Edit button is disabled until the current list loads.
Predefined purges tab
Allows you to define frequently used purges (e.g., homepage cache) once and then run them with one click. A record consists of one or more purge steps and can be restricted to run only during certain hours.
Toolbar
- Search: filters instantly by text in key or description (placeholder: "Key or description").
- Filter lists: Run interval, Runnable now, Favorite, Created by, Changed by. You can select one or more values in each; the count of records with that value is shown in parentheses. Records matching any selected value in the same filter and all other filters are listed.
- Group by: groups the list by one of the filter fields; default is No grouping. In grouped view, each group is a collapsible header with record count; pagination is disabled.
- Clear filters: visible only when a filter is selected.
- Columns icon: selects visible columns. The Key column cannot be hidden. Your selection is remembered in this browser.
- Favorites: shows records marked as favorite in a dropdown; selecting one opens the run confirmation. Disabled if no favorites; favorites outside run interval appear disabled.
- Download CSV: downloads the currently visible records (with search, filters, and sorting applied) as a semicolon-separated CSV file. The file includes hidden columns and fields: Key, Description, Run interval, Steps, Created, Modified, and Last run. Disabled if the list is empty.
- Add predefined purge: opens the new record form.
List
| Column | Meaning |
|---|---|
| Key | Short name of the record; description below. Favorite records have a star icon before the key. |
| Steps | Each purge step in the record: purge type · integration. If unreadable, a red Parameters unreadable label appears. |
| Run interval | Allowed time range; empty means Any time. Below shows Runnable (green) or Outside run interval (gray) label. |
| Created | Creation date · creator. |
| Changed | Last modification date · modifier. |
| Last run | Last run date · runner. |
Click column headers to sort: first click ascending, second descending, third removes sorting. Empty values are last in both directions. If no records, "No predefined purge" is shown. Shows 5, 10, or 20 records per page; default 10. On the right of each row are Run, Edit, and Delete icons.
Adding and editing predefined purges
- Press Add predefined purge or the Edit icon on a row.
- Fill in the fields below.
- In the Purge steps section, enter integration, purge type, and required values for each step. To add another step, press Add step; to remove a step, press Remove step.
- Press Save. On success, a Saved notification appears and the list refreshes.
| Field | Required | Description / rule |
|---|---|---|
| Key | Yes | Short name identifying the record (e.g., homepage). Max 255 characters. |
| Description | No | Max 255 characters. Shown in the Favorites menu. |
| Run interval | No | Format HH:mm-HH:mm, max 11 characters (e.g., 01:00-08:00). Empty means always runnable. If invalid, warning "Enter time range in HH:mm-HH:mm format." appears. |
| Favorite | No | If checked, record appears in Favorites menu. |
| Purge steps | At least one step | Up to 50 steps allowed; after 50, Add step is disabled. When only one step remains, Remove step is disabled. |
The Save button is disabled if Key is empty, Run interval is invalid, or any step is missing or invalid. Run interval errors appear below the field; the first step error appears at the bottom of the form. If the server rejects the record, a "Operation rejected by server." notification appears and the form remains open.
Purge step fields
Each step selects Integration (Web) and Purge type. New steps default to ClearMemoryCache. Type names appear technically; required values vary by type. The same fields are used in the Custom purge tab form.
| Purge type | Required value | Rule |
|---|---|---|
ClearMemoryCache, ClearProductCache, ClearCategoryCache, ClearOutputCache |
Prefixes | One prefix per line (or comma-separated). At least one prefix required. |
ClearOutputCacheAll |
— | "This type does not accept extra values." |
StockControlCache |
Status | Cannot be empty. |
ClearElasticCacheByCRC |
Crc | Numeric only, max 20 digits. Otherwise, warning "Crc must be a positive integer." appears. |
ClearProductCacheById, ClearCategoryCacheById |
IDs and Index | One numeric ID per line or comma; digits only, max 18 digits per ID. Empty Index defaults to 0; must be zero or positive integer. |
If no integration is selected in a step, a warning "Integration selection is required." appears.
Running a predefined purge
- Press the Run icon on the row or select the record from the Favorites menu.
- Read the confirmation checkbox message: "“…” purge (… step) will be applied to the live store cache. Do you confirm?" and press Run.
If accepted, a notification "Operation received, cache purge added to queue." appears and the Last run column updates. The Run icon is disabled if the record is outside the run interval; the server also rejects requests if the record is out of interval, unreadable, or has no steps, showing the reason.
Deleting a predefined purge
Press the Delete icon on the row. In the Delete predefined purge box, read the warning "“…” record will be deleted. No purge will be performed; only the record will be removed." and press Delete. Deletion only removes the record; it does not clear cache. On success, a Deleted notification appears. Deleted records cannot be restored.
Pending tab
Shows accumulated but not yet processed cache purge requests in the store. Requests are processed automatically every few minutes; this tab lets you see the backlog and process it immediately if needed. The list does not refresh automatically; press Refresh list to see the current status.
| Column | Meaning |
|---|---|
| Type | Type of purge request; below shows how many keys it contains (… keys). Hovering shows the list of keys. |
| Integration | Store integration the request belongs to. |
| Method | Request method (technical name). |
| Distinct | Number of distinct values in the backlog. |
| Total | Total number of requests in the backlog. |
| First | Time of the oldest request in the backlog. |
| Latest | Time of the newest request in the backlog. |
The list loads only when you open this tab. If no backlog, "No pending cache message" is shown.
The search box (placeholder: "Type, integration, method or key"), Type, Integration, and Method filters, Group by, Columns, column header sorting, and 5/10/20 page size work the same as in the Predefined purges tab. Download CSV exports only visible columns.
Processing a single backlog
Press the Process icon on the right of the row. In the confirmation box, read "… backlog (… requests) will be processed now and the related cache will be cleared. Do you confirm?" and confirm with Process. No upper limit applies to single backlog processing.
Processing all pending
Press the Process all pending button and confirm the message "… entire backlog will be processed and cache refreshed. Do you confirm?" This button:
- Is disabled if no pending records.
- Is disabled if the number of pending backlogs reached the upper limit, showing: "Too many pending records (…). Bulk processing is allowed only up to … records; please wait for scheduled renewal or process individually." This limit does not apply to owner admin accounts exempt from the full refresh gate.
On successful processing, a notification "Operation received, cache purge added to queue." appears. When the server responds, the list refreshes regardless of acceptance or rejection. If the server rejects bulk processing (e.g., limit exceeded), a "Operation rejected by server." notification appears.
Custom purge tab
Allows instant purging without saving records. There are three sections.
Custom cache purge
"Sends a single purge message to the selected integration. Allowed once per minute per integration."
- Select Integration (Web) and Purge type; enter the required value according to the type (see the Purge step fields table above).
- Press Send. The button is disabled if fields are missing or invalid; if integration is selected, the error reason appears below the form.
- Confirm the message "… purge for … will be sent to the live store. Do you confirm?" with Send.
If you send a second request to the same integration within one minute, it may be rejected; wait one minute and try again.
Partial purge
Used to instantly delete specific prefixes from the store’s memory and output cache. Integration must be selected above.
- Press the Clear button.
- Read the warning in the Partial purge box: "Selected prefixes will be instantly deleted from the live store’s memory and output cache. Do you confirm?"
- Enter the prefixes to purge in the Prefixes field, one per line.
- Press Clear. The button is disabled if the field is empty. Enter prefixes one per line, not comma-separated.
Shortcuts
Allows saving frequently used prefix lists by name for repeated execution.
| Column | Meaning |
|---|---|
| Shortcut name | Name of the shortcut; prefixes included shown below. |
| Last run by | Last runner · date. |
| Actions | Run button. |
- Add shortcut: fill in Shortcut name and Prefixes (one prefix per line) and press Save. The button is disabled if the name is empty or no prefixes are entered. Shortcuts are not saved per integration; the integration is selected at run time.
- Run: confirm the message "… shortcut will clear the live store cache. Do you confirm?" with Run. The shortcut applies to the integration selected above; if no integration is selected, the button is disabled.
If no shortcuts exist, "No records found" is shown. Up to 50 shortcuts are displayed. Shortcuts cannot be edited or deleted on this screen.
Common situations
- Most buttons are disabled. You have not selected an Integration (Web) above. Select the store to apply the operation first.
- "All products", "All categories" or "Whole cache" buttons cannot be pressed. Full refresh gate is closed: you are outside the allowed time window and the pending change threshold is not exceeded. Check allowed hours on the Time window card in the Renewal tab or clear only the affected area via Predefined purges or Custom purge.
- Cannot run predefined purge. You are outside the record’s run interval (Outside run interval label) or the record’s steps are unreadable (Parameters unreadable). Edit the record and save the steps again or wait for allowed time.
- Changes did not reflect on the storefront. Purge requests are queued first; effects appear when processed. Check accumulated requests in the Pending tab; process immediately with Process if needed.
- "Operation rejected by server." notification. The request was not accepted by the server; read the explanation (e.g., run interval or upper limit). If the problem persists, contact your system administrator.
- Receiving "Something went wrong" notification during full refresh, partial purge, shortcut, or prefix operation. These operations require additional admin rights besides screen access; if your account lacks these rights, the request is rejected. Provide the notification details to your system administrator.
- Screen shows "Service not configured." The service linked to this screen is not defined in this installation. Notify your system administrator.