Primary responsibility
A decorative spacer button. Renders as either a blank slot or a configurable placeholder image. Used to balance grid layouts or reserve a slot for future content without leaving the layout broken.
Settings
| Setting |
Type |
Environment |
Purpose |
placeholder_image |
image |
per-button |
Optional image to render |
tappable |
yes-no |
per-button |
If off, the button is purely decorative (no tap action) |
style_* |
various |
per-button |
Background color |
When to use
- A 3×3 grid layout has 7 real buttons; add 2 placeholders to fill the row
- An admin is mid-build and wants to reserve a slot without committing to a content type yet
- A category list with predictable empty trailing rows on small screens
Gotchas
- Placeholders count toward layout limits. If a layout caps at N rows, placeholders eat slots like real buttons.
tappable = on with no action produces a button that responds to taps but does nothing — use this to mock layout interactions, not in production.
Related articles
| Field |
Value |
| Article type |
Screen Reference |
| Plugin slug |
mam-main |
| Applies to plugin version |
2.1.11+ |
| Category |
App Settings Reference |
| Audience |
WordPress admin |
| Class name |
local_app_placeholder (frozen) |
| Source file |
includes/content-classes/local-app-placeholder-button-class.php |
| Last verified |
2026-05-02 |
