litespeed/update-placeholder-settings changes the placeholder shown while a lazy-loaded image arrives: whether a responsive placeholder is used, its colour, and an inline SVG.
LQIP — the low-quality preview generated from the real image — is a QUIC.cloud service and is not part of this suite.
At a glance
| Ability | litespeed/update-placeholder-settings |
| Toolset | LiteSpeed Cache — toolset/litespeed |
| Group | LiteSpeed Cache › Images & Lazy Load |
| Requires | LiteSpeed Cache, 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 |
How it works
Without a placeholder, a lazy-loaded image occupies no space until it arrives, and everything below it jumps when it does. That layout shift is both unpleasant and directly measured by page-experience scoring.
A responsive placeholder is an empty image of the right dimensions. It reserves the space, so nothing moves. This is the setting that matters, and it is usually enough on its own.
The colour and the inline SVG are refinements: a placeholder tinted to match the design reads as deliberate rather than as a gap, and an SVG can carry a shape or a logo.
LQIP goes further — a blurred thumbnail of the actual image, so the layout is reserved and the content is hinted. It requires generating a preview per image, which is done by QUIC.cloud, which costs credits. No ability in this suite spends credits, so the toggle is not exposed.
The write is a patch, not a replacement. Send one key and one key changes; everything else in the area is left alone. The response names the keys that actually moved, so a payload that matched the existing values comes back with an empty list rather than a misleading success.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
settings | object | Yes | A map of setting key to new value. Keys outside this area are refused, and the refusal lists what the area accepts. |
What comes back
| Name | Type | What it is |
|---|---|---|
updated | array | The keys that actually changed. An empty array means every value you sent was already set. |
settings | array | Every setting in the area after the write, in the read shape. |
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:
Use a grey placeholder while images load.
It resolves to one call:
{
"ability": "litespeed/update-placeholder-settings",
"parameters": {
"settings": { "media-placeholder_resp": true, "media-placeholder_resp_color": "#e5e5e5" }
}
}Worth knowing
- The responsive placeholder is what stops the page jumping. Have it on.
- LQIP is a QUIC.cloud service and is deliberately not exposed here.
- A tinted placeholder reads better than a blank one.
- Purge after changing.
Related abilities
- Update Lazy Load Settings — the feature this supports
- Get Media Settings — read the current placeholder
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category