elementor/update-theme-builder-conditions replaces the display conditions attached to a template.
Pass an empty array to clear all conditions, which takes the template out of service without deleting it.
At a glance
| Ability | elementor/update-theme-builder-conditions |
| Toolset | Elementor — toolset/elementor |
| Group | Elementor › Templates & Theme Builder |
| Requires | Elementor, active on the site |
| Capability | manage_options |
| Safety | Writes data |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
Replacement, and what that means live
Conditions are replaced wholesale rather than merged. That is the right primitive for a rule set where order and overlap matter — merging would produce combinations nobody wrote — but it means a write must include every condition you want to keep.
The effect is immediate and site-wide. Adding a condition puts the template in front of visitors on the matching pages from the next request; clearing conditions takes it away just as fast, and the theme’s own template takes over.
Clearing is a useful operation in its own right: it disables a Theme Builder template without trashing it, which is the reversible way to test whether it is causing something.
Theme Builder templates take effect through display conditions: rules saying which parts of the site a header, footer, single or archive template applies to. A template with no conditions is a template that renders nowhere.
When two templates compete, adjusting the conditions on the one that should lose is usually cleaner than making the winner more specific.
Idempotent.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
template_id | integer | Yes | The template post ID. |
conditions | array | Yes | The complete condition set. An empty array clears them all. |
What comes back
| Name | Type | What it is |
|---|---|---|
template_id | integer | The template. |
conditions | array | The conditions after the write. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
Make this header apply to the whole site.
It resolves to one call:
{
"ability": "elementor/update-theme-builder-conditions",
"parameters": {
"template_id": 640,
"conditions": [{ "type": "include", "name": "general" }]
}
}Worth knowing
- Replaced wholesale — include everything you want to keep.
- Takes effect on the next request, site-wide.
- An empty array disables the template reversibly.
- Idempotent.
Related abilities
- Get Theme Builder Conditions — read before replacing
- Clear Elementor Cache — if the change does not appear
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category