Glossary Docs Developers ↗
Glossary

Pro features

Automation, Image Processor, Series from CSV, the AI Content Generator and dynamic blocks.

23 sections262 entries

Image Processor (Batch Process) Pro 15 items #

Re-encode, resize, convert, optimize and optionally run an Action over many Media Library images in one pass, right in your browser.

The image Processor (Batch Process)

The Batch Process dialog takes a set of attachment ids, applies an optional saved Action plus export settings, and writes the results either as new attachments or as versioned overwrites. Everything runs client-side through the headless render pipeline, with a live per-image progress list.

Select from Library

#

Opens the WordPress media modal to pick images to process; picks are added to the current selection. Only shown when the media modal is available.

Filterimages onlyModeadd to selection

Paste attachment IDs

#

A text field to type or paste attachment ids directly, separated by spaces, commas or semicolons. Used when you already know the ids or the media modal is unavailable.

Placeholderor paste attachment IDs: 12, 15, 20

Tip. Duplicate and non-positive ids are ignored automatically.

Quick Presets

#

Eight compact one-tap cards that set format, quality and max size together. The active card is highlighted when the current settings match it.

OptionsOptimize (Auto), Web JPEG (JPEG 80), WebP Small (WebP 75), AVIF Small (AVIF 60), Web 1600 (JPEG 82, max 1600 px), Email 1200 (JPEG 70, max 1200 px), Lossless PNG (PNG 100), Max Quality (JPEG 100)

Action

#

Chooses a saved editor Action to run on every image before export, or re-encode only to just convert and compress without edits.

Defaultre-encode only

Format

#

A five-way switch for the output encoding. Auto is the Optimize mode (smallest file with no visible difference); AVIF is encoded by the bundled WASM codec.

OptionsAuto, JPEG, PNG, WebP, AVIFDefaultJPEG

Save As

#

Chooses where results go: New attachments creates fresh Media Library entries, or Overwrite (versioned) replaces the originals while keeping a version history.

OptionsNew attachments, Overwrite (versioned)DefaultNew attachments

Quality

#

Slider for the output compression quality. Higher means larger, cleaner files. Ignored for lossless PNG in practice.

Range10 to 100Default90

Watermark

#

When ticked, applies your configured watermark to each processed image. Only shown when a watermark is set up in the editor.

DefaultOffShown whena watermark is configured

Process N image(s)

#

Starts the batch and shows a live list where each row reports pending, working, done (with a link) or error. Disabled while running or when nothing is selected; the label reflects the image count.

Enabled whenat least one image selected

Cancel

#

Closes the dialog. Disabled while a batch is running so you do not interrupt it mid-pass.

Tip. Pressing Escape also closes the dialog, but only when nothing is running.

Optimize (Auto format)

#

The Auto format re-encodes each image at the lowest quality that still looks identical (a perceptual SSIM search), preferring WebP with JPEG fallback. When overwriting, an image is only replaced for a meaningful saving (at least 5% or 10 KB); otherwise it reports already optimal, which also protects against quality loss from repeated runs.

Guard>= 5% or >= 10 KB saving on overwrite

Max Size

#

Downscales every image so its long side stays within the chosen limit before encoding; Original size keeps dimensions. Works with every format. A real downscale always saves, even when the byte saving alone would be marginal.

OptionsOriginal size, <= 2048 px, <= 1600 px, <= 1200 px, <= 800 px

WASM codecs

#

Bundled WebAssembly encoders (MozJPEG, WebP, AVIF) plus a lossless OxiPNG pass take over encoding when available: better compression than the browser's native encoders, WebP output even on Safari, and AVIF output at all. Loaded lazily on the first run; the native encoders remain as automatic fallback.

CodecsMozJPEG, WebP, AVIF, OxiPNG (lossless PNG)

Results

#

A scrollable section that lists every processed image with its title, new file size, format, dimensions, the saving in green, and an open link to the saved file. Skipped images show already optimal, failures show the error message.

Statespending, working, done, already optimal, error

Selection grid

#

Selected images show as cards with their real Media Library thumbnail and title (plus id), so you can verify the batch before running it. Up to eight cards are shown, the rest is summarized as +N.

Batch Process: preset cards, options and states Pro 21 items #

The quick preset cards, dropdown and segmented options, and progress states inside the Batch Process (Image Processor) dialog.

The Batch Process dialog (batch-dialog.jsx, opened as Image Processor) re-encodes, resizes and converts many library images in one browser-side pass. These are the option values and states the main list did not name.

Optimize

#

The first Quick Preset card. Sets the format to Auto: smallest file with no visible difference (perceptual auto quality, WebP preferred).

SetsAuto format

Web JPEG

#

A one-tap Quick Preset card. Sets the format to JPEG at quality 80, a good default for web photos.

SetsJPEG, quality 80

Lossless PNG

#

A Quick Preset card. Sets the format to PNG at quality 100 for a lossless result.

SetsPNG, quality 100

WebP Small

#

A Quick Preset card. Sets the format to WebP at quality 75 for small file sizes.

SetsWebP, quality 75

Max Quality

#

A Quick Preset card. Sets the format to JPEG at quality 100 for the highest-quality JPEG.

SetsJPEG, quality 100

re-encode only

#

The default option of the Action dropdown. Applies no saved action, so images are only re-encoded and resized to the chosen format and quality.

Defaultselected

Format (Auto / JPEG / PNG / WebP / AVIF)

#

A segmented control for the output file type of the batch. Auto runs the Optimize mode; AVIF needs the bundled WASM codec (loaded automatically).

OptionsAuto, JPEG, PNG, WebP, AVIFDefaultJPEG

New attachments

#

The Save As option that saves every result as a brand-new Media Library attachment, leaving the originals in place.

Defaultselected

Overwrite (versioned)

#

The Save As option that overwrites each source image in place, keeping a version so you can roll back.

ControlSave As option

Source Images / %d selected

#

The section header for the image list and its live count of how many attachments are queued (from library picks plus pasted IDs).

Typeheader and counter

Remove (source image)

#

The × on a picked image tile. Drops that attachment from the batch (available only for library-picked images, not pasted IDs).

Controlbutton per tile

No images yet: add from the library or paste IDs.

#

The empty state shown before any source image has been added.

Typeempty state

Progress rows (…, spinner, done, error)

#

The live per-image progress list. means pending, a spinner means working, done is a link to the result, and errors show in red.

Statespending, working, done, error

Processing…

#

The label on the primary button while the batch runs, replacing Process N image(s) and showing a spinner.

Typebutton state

Batch finished: %1$d processed, %2$d failed.

#

The summary toast after a run, reporting how many images succeeded and how many failed.

Typetoast

Footer summary line

#

The footer text that previews the batch: image count, format and quality, and whether results become new attachments or overwrite (versioned).

Locationdialog footer

AVIF Small

#

A Quick Preset card. Sets the format to AVIF at quality 60: the most modern codec with the smallest files for photos.

SetsAVIF, quality 60

Web 1600

#

A Quick Preset card for content images: JPEG at quality 82, downscaled to at most 1600 px on the long side.

SetsJPEG, quality 82, max 1600 px

Email 1200

#

A Quick Preset card for images that travel by mail or newsletter: JPEG at quality 70, at most 1200 px on the long side.

SetsJPEG, quality 70, max 1200 px

already optimal

#

The per-image state in Optimize mode when overwriting would not save at least 5% or 10 KB. The original file is kept untouched and the summary toast counts these images separately.

open (result link)

#

Each finished row in the Results list links to the saved file in a new tab, so you can inspect the output immediately.

Series from CSV (Generate from CSV) Pro 11 items #

Turn the current document into a template and generate one Media Library image per CSV row by filling in {{placeholder}} text.

The series from CSV (Generate from CSV)

Generate from CSV treats your open document as a template. Any {{key}} written into a text layer is a placeholder; upload a CSV whose column headers match those keys, and each row renders the document once and saves it as a new image.

Nothing needs to be pre-configured: the placeholders you type define the columns the CSV should have. The file name for each image comes from a column you choose.

Placeholders in this document

#

A read-only list of the {{key}} tokens detected in the document's text layers. These define the columns your CSV should carry. If none are found, the dialog explains to add one like {{title}} first.

Tip. Type placeholders directly into text layers; any name works.

Your CSV should look like this

#

A preview block showing an example CSV matching the current placeholders: a filename column plus one column per placeholder. Shown before a CSV is loaded.

Download sample CSV

#

Downloads a ready-made wpie-series.csv with the correct headers and two example rows, so you can fill it in instead of building the file by hand.

File namewpie-series.csv

Choose CSV file…

#

Opens a file picker for a .csv file. After loading, the file name and row count show, and the CSV's headers appear as chips marked used or unused against your placeholders.

Accepts.csv

Header chips (used / unused)

#

Each CSV column header is shown as a chip. A used chip matches a placeholder in the document; an unused chip is a column that will not be applied.

Missing in CSV

#

A warning listing any document placeholders that have no matching CSV column. Those placeholders stay empty in the output rather than blocking the run.

Behaviormissing placeholders render empty

File name from column

#

Chooses which CSV column supplies each generated image's file name. Defaults to the first column. Names are cleaned to safe characters, with a fallback like image-1 if empty.

Defaultfirst CSV column

Format

#

The output image format for every generated row.

OptionsPNG, JPEG, WebPDefaultPNG

Quality

#

A number field for compression quality of the generated images. Values are clamped to the valid range.

Range10 to 100Default90

Generate N graphics

#

Renders one image per CSV row and saves each as a new Media Library attachment, showing a live progress list with per-row done links or errors. Disabled until a CSV with rows and at least one placeholder are present.

Enabled whenCSV loaded and placeholders exist

Cancel / Close

#

While running, a Cancel button stops after the current row; otherwise a Close button dismisses the dialog. Escape also closes it when idle.

While runningCancel (stop after current row)

Generate from CSV: options and states Pro 6 items #

The export options, empty states and progress messages in the Series from CSV dialog.

The Generate from CSV dialog (merge-dialog.jsx) fills {{key}} placeholders in the current document from each CSV row and saves one Media Library image per row. These are the smaller controls and states not yet listed.

Format (PNG / JPEG / WebP)

#

The output file type for every generated image. Note the default here is PNG, unlike the Batch Process dialog.

OptionsPNG, JPEG, WebPDefaultPNG

Quality (CSV series)

#

A number field for the export quality of each generated image. Values outside the range are clamped.

Range10 to 100Default90Controlnumber input

None found. (no placeholders)

#

The message shown when the document has no {{placeholder}} text yet. Type one like {{title}} into a text layer first; the placeholders define your CSV columns.

Typeempty state

Progress rows (CSV)

#

The live per-row list. is pending, a spinner is working, done links to the saved image, and errors show in red. Rows are labeled by the name column value.

Statespending, working, done, error

%d rows (CSV summary)

#

After a CSV is chosen, the file name and its row count are shown next to the Choose CSV file button.

Typefile summary

%d graphics generated.

#

The success toast after a run, reporting how many images were saved to the Media Library.

Typetoast

Generate Content (AI content generator) ProAI 16 items #

Produce a complete WordPress draft in one pass: article text plus featured image, OG image, body images and an infographic, all in your brand.

The generate Content (AI content generator)

Generate Content ties the content template, brand kit and a dynamic design template together. You describe the assignment (topic, keyword, context, internal links) and the pipeline writes the article, renders every image in your brand, and files a WordPress draft with SEO meta.

It needs a text-capable AI provider (Anthropic, OpenAI or Gemini). Without an image provider it still creates the draft, but without images.

Brand Kit

#

Selects the brand kit whose profile, colors, fonts and variables steer the article tone and the generated images. A pencil button opens the Brand Kits editor. Defaults to the first kit.

Defaultfirst available kit

Content template

#

Chooses which reusable content recipe (model setup, prompts, output rules) writes the article. Managed in the Content Templates dialog.

Dynamic template (featured image)

#

Chooses the design template used to render the featured image. Pick AI image (no dynamic template) to generate a plain AI image instead. Templates are grouped by the selected brand kit and a Without Brand Kit group.

DefaultAI image (no dynamic template)

Action

#

Replays a saved editor Action on the rendered featured image, for example a black-and-white look. Choose No action to skip. Appears only when a dynamic template is selected and you have saved Actions.

DefaultNo action

Enhance design

#

Gives the rendered featured image one extra AI polish pass. Costs one more generated image, and fine text may be redrawn slightly. Shown when a dynamic template is chosen and an image provider is configured.

DefaultOff

Topic

#

The free-text subject of the article, for example How to winterize a garden pond. Required before you can generate.

PlaceholderTopic of the article…RequiredYes

Suggest topics

#

Asks the AI for three topic ideas drawn from your brand profile and category, each with a focus keyword and a short rationale. Clicking an idea fills the topic and keyword fields. Needs a text provider.

Returns3 ideas

Focus keyword

#

The main SEO keyword for the article. Used to steer the writing and written into the SEO plugin's focus keyword field on the draft.

Category

#

Assigns the resulting draft to a WordPress category. Choose No category to leave it unassigned.

DefaultNo category

Context (optional)

#

A free-text box for facts, offers or target-audience notes the article should use. Helps ground the writing in your specifics.

Rows3OptionalYes

Load suggestions

#

Searches your posts and pages for the best internal-link targets matching the focus keyword or topic (service pages are prioritized) and lists them as toggleable rows that add or remove lines in the links box.

Returnsup to 8 candidates

Progress (generation steps)

#

A progress bar plus step chips that light up as the pipeline runs. The steps are the full set of outputs produced for the draft. A header shows elapsed time and percent complete.

StepsWrite article, Body images, Featured image, Social/OG image, Infographic, Create draft

Open draft in WordPress

#

After a successful run, links straight to the newly created draft's editor. The panel also reports the draft's post id and any non-fatal image failures.

Shown whena draft was created

Generate post

#

Starts the whole pipeline. Disabled until a text provider, a content template and a topic are all present. The label changes to Generating… while it runs.

Enabled whentext provider + content template + topic

Cancel / Close

#

While a run is live, Cancel signals the pipeline to stop; otherwise Close dismisses the dialog. Escape does not close mid-run.

While runningCancel

Content Templates ProAI 19 items #

Manage the reusable AI article recipes used by Generate Content: model setup, prompts and output rules.

The content Templates

Each content template is a saved recipe of how an article is written and which images accompany it. The left column lists starter templates and your own; the right side is the form. Starters are read-only, so saving an edited starter creates an editable copy.

Prompt placeholders like {company}, {topic} or {focus_keyword} are resolved from the brand kit and the assignment at generation time.

Template list

#

The left column of saved templates. Each row shows the name, language and description; built-in ones carry a Starter chip. Click to load one into the form.

Starter chipmarks read-only built-in templates

+ New template

#

Clears the form to a blank template so you can build one from scratch.

Tip. Blank defaults: German language, Normal thinking, web search on, 3 body images, 1200 min words.

Name

#

The template's display name, shown in the list and in the Generate Content picker. Required to save.

RequiredYes

Output language

#

The language the finished article is written in, regardless of the language of the prompts. The server injects an explicit output-language instruction from this setting.

OptionsDeutsch, English, Français, Español, Italiano, Nederlands, Português, PolskiDefaultDeutsch

Description

#

A short note about what this template is for. Shown under the name in the list and as a hint in Generate Content.

OptionalYes

Text provider

#

Which AI text model writes the article. Choose Default text provider to use the editor's global default, or pin a specific one.

OptionsDefault text provider, Anthropic Claude, OpenAI, Google GeminiDefaultDefault text provider

Image provider

#

Which AI image model renders the images. Choose Default image provider or pin a specific one.

OptionsDefault image provider, Google Gemini, OpenAIDefaultDefault image provider

Thinking budget

#

How much internal reasoning the text model spends before writing. More thinking generally means a stronger article at higher cost.

OptionsOff, Normal, Extended (recommended)DefaultNormal

Web search

#

When on, lets the model research current sources while writing the article.

DefaultOn

System prompt

#

The large instruction block that defines the writer's role, tone and rules. This is the core of the recipe and can reference placeholders like {company} and {topic}.

Rows14

Image prompt (style template for all images)

#

A shared style description applied to every image the pipeline generates, so body images, featured and OG all look consistent. A Style button inserts ready-made style phrases.

Rows6

Output directives

#

Extra rules appended to the generation, for example structural or formatting requirements the article must follow.

Rows10

Body images

#

How many in-article body images the pipeline generates. Set 0 for a text-only article.

Range0 to 10Default3

Body aspect

#

The aspect ratio for the body images.

Options16:9, 4:3, 3:2, 1:1, 3:4, 9:16Default16:9

Min. words

#

A minimum word count target for the generated article body.

Range0 to 20000Default1200

Infographic

#

When on, adds a summarizing infographic after the quick box in the article.

DefaultOn

Save button

#

Saves the template. The label is Create template for a new one, Save for an existing user template, and Save as copy when editing a starter (which creates an editable copy rather than changing the starter). Disabled until a name is entered.

LabelsCreate template / Save / Save as copy

Delete

#

Deletes the current user template after a confirmation click (Really delete?). Not available for starter templates.

Confirmclick twiceUnavailable forstarters

Content Templates: option lists, defaults and states Pro 11 items #

The dropdown option values, section headers, default values and button states in the Content Templates editor.

The Content Templates dialog (content-templates-dialog.jsx) manages the reusable AI article recipes. These are the option lists and defaults behind its controls, plus its section headers and save/delete states.

Text provider options

#

The provider choices for the article text model. Default text provider uses the site default; the rest force a specific vendor.

OptionsDefault text provider, Anthropic Claude, OpenAI, Google GeminiDefaultDefault text provider

Image provider options

#

The provider choices for the image model. Default image provider uses the site default.

OptionsDefault image provider, Google Gemini, OpenAIDefaultDefault image provider

Thinking budget options

#

How much reasoning the text model spends while writing. Off is fastest, Extended (recommended) gives the most thorough article.

OptionsOff, Normal, Extended (recommended)DefaultNormal

Output language options

#

The language the finished article is written in. The prompt texts can stay in any language; the server injects an explicit output-language instruction from this setting.

OptionsDeutsch, English, Français, Español, Italiano, Nederlands, Português, PolskiDefaultDeutsch (de)

Body aspect / Featured aspect options

#

The aspect ratios offered for the body images and the featured image dropdowns.

Options16:9, 4:3, 3:2, 1:1, 3:4, 9:16Default16:9

Output field ranges and defaults

#

Numeric limits for the output fields: Body images accepts 0 to 10 (default 3) and Min. words accepts 0 to 20000 (default 1200). A blank template also starts with Web search on, Deep research off, and Infographic on.

Body images0 to 10, default 3Min. words0 to 20000, default 1200

Starter (chip)

#

A chip on read-only starter templates in the list. Editing and saving a starter creates your own user copy instead of changing the starter.

Typelist chip

Save as copy / Create template / Save

#

The primary button changes with context: Save as copy for a starter, Create template for a new one, and Save when updating an existing user template.

Typebutton states

Really delete?

#

The Delete button asks for a second click, turning into Really delete? before it removes a user template. Starters cannot be deleted.

Typeconfirm state

Settings / Prompts / Output (section headers)

#

The three grouping headers inside the form. Settings holds the thinking budget and research toggles, Prompts holds the system, image and directive prompts, and Output holds the image counts, aspects and word count.

Typesection labels

Placeholders like {company}, {topic} or {focus_keyword}

#

The footer hint. Tokens like {company}, {topic} and {focus_keyword} written into the prompts are resolved from the brand kit and the current assignment.

Typefooter hint

Generate Content: steps, option values and states Pro 21 items #

The pipeline step labels, dropdown option values, suggestion lists and progress states in the Generate Content dialog.

The Generate Content dialog (create-post-dialog.jsx) writes a full draft in one run. These are the individual progress steps, empty option values, suggestion pickers and progress states not covered by the main control list.

Write article

#

The first pipeline step. The AI writes the full structured article from the topic, keyword and context.

Step1 of 6

Body images

#

Pipeline step that generates the in-article images (count and aspect come from the content template).

Step2 of 6

Social/OG image

#

Pipeline step that renders the Open Graph and Twitter share image.

Step4 of 6

Infographic

#

Pipeline step that builds the summarising infographic (when the content template has it enabled).

Step5 of 6

Create draft

#

The final step. Assembles the article and all images into a WordPress draft with SEO meta, tags and category.

Step6 of 6

AI image (no dynamic template)

#

The default option of the Dynamic template (featured image) dropdown. The featured image is generated as a plain AI image instead of being composed from a template.

Defaultselected

Without Brand Kit (option group)

#

An option group in the dynamic-template dropdown holding templates that are not tied to any brand kit, shown below the selected kit's own templates.

Typeoptgroup

No Brand Kit

#

The placeholder option shown in the Brand Kit dropdown when no brand kits exist yet.

Typeempty option

No category

#

The default option of the Category dropdown. Leaves the draft uncategorised.

Defaultselected

No action

#

The default option of the optional Action dropdown (shown when a dynamic template is chosen). Leaves the rendered featured image without a replayed editor action.

Defaultselected

Topic idea rows

#

After Suggest topics, up to three clickable idea rows appear, each with a topic, focus keyword and a short rationale. Clicking one fills the Topic and Focus keyword fields.

Sourcebrand-kit profileCount3

No matching posts found.

#

Shown under the internal links box when Load suggestions returns nothing for the keyword or topic.

Typeempty state

Progress header (Starting… / Step X of Y / Finished / Failed)

#

The progress line above the bar. It reads Starting…, then Step X of Y: label…, ending in Finished or Failed, with elapsed time and a percentage on the right.

Showselapsed mm:ss and percent

Draft #%d created.

#

The success panel after a run. Reports the new draft's post id and offers an Open draft in WordPress link.

Typeresult panel

No text-capable AI provider configured (warning)

#

A banner shown when no text provider is set. Add an Anthropic, OpenAI or Gemini key in the settings first; without it Generate is disabled.

Typeinline warning

No image provider configured (warning)

#

A banner shown when text works but no image provider is set. The draft is created without any images.

Typeinline warning

Setup (section header)

#

The header for the top row of the dialog holding Brand Kit, Content template and the featured-image dynamic template.

Typesection label

Thinking… / Searching… (loading labels)

#

The Suggest topics button shows Thinking… while ideas load, and the Load suggestions button shows Searching… while link candidates load.

Typebutton states

Dynamic Template Shortcodes (in-editor dialog) Pro 5 items #

One dialog that bakes and hands out every shortcode the dynamic-image family offers, for use in the Classic editor, Elementor's shortcode widget and any other builder.

Reached from View, Dynamic Template Shortcodes, this dialog explains and produces the three shortcodes so you can use a design outside Gutenberg. The Live Badge is baked from the current design; the Personalized and Dynamic Image shortcodes reference a saved dynamic template by its id.

Personalized and Dynamic Image both require the current design to be saved as a dynamic template first (File, Save as Dynamic Template), because their shortcodes point at the template id.

Bake badge from this design

#

Exports the current document as a vector Live Badge SVG and stores it server-side, returning a [wpie_live_badge] shortcode. Updating the design's dynamic template re-bakes the badge automatically; the button (labelled Re-bake badge once a badge exists) covers designs you change without saving to a template, and the shortcode stays the same either way. Vector content (text and shapes) works best; pixel layers embed as static images.

Produces[wpie_live_badge uid="…"]

Live Badge copy row

#

Shows the baked badge shortcode in a read-only field with a Copy button. Copying confirms with a toast, or tells you to select and copy by hand if the browser blocks clipboard access.

Personalized parameter mapping

#

For each named text layer, a parameter field and a fallback text field. The parameter is the URL query key (for example name) that will replace the layer; the fallback shows when the parameter is missing. Parameter input strips characters other than letters, digits, underscore and dash.

Pernamed text layer

Personalized copy row

#

Builds and shows the [wpie_personalized] shortcode with the template id and the map string assembled from your parameter/fallback entries, with a Copy button. Requires the design to be a saved dynamic template.

Produces[wpie_personalized template="…" map="…"]

Dynamic Image copy row

#

Shows the [wpie_dynamic_image template="…"] shortcode for the current saved template, with a Copy button. Saves mark the baked image stale, and the next open editor session re-bakes it; until the first bake, the template preview shows.

Produces[wpie_dynamic_image template="…"]

Dynamic-image Gutenberg blocks Pro 9 items #

Three block-editor blocks that place your dynamic templates directly onto pages and posts, each with its own inspector settings.

The dynamic-image Gutenberg blocks

These blocks live in the Media category of the Gutenberg inserter. Dynamic Image bakes a real image on every save; Live Badge is a baked vector whose bound texts the server fills in as the page is served and which re-bakes when its template is updated; Personalized Image renders live in each visitor's browser with URL parameters applied.

Every block shares two inspector controls: a Dynamic template picker and a Width (%) slider. Blocks render server-side on the front end.

Dynamic Image (WPIE)

#

A real image baked from a dynamic template filled with this post's data, re-rendered on every save so the front end serves a plain, stable <img>. Add it, pick a template, then save (or press Render now) to bake.

Blockwpie/dynamic-imageCategoryMedia

Render now

#

Bakes the Dynamic Image block immediately instead of waiting for the next post save. The button shows Rendering… while it works.

InDynamic Image block settings

Live Badge (WPIE)

#

A vector badge whose bound texts are substituted server-side on every page view, so it stays current with no re-render. Pick a template and press Create badge; vector-only designs (text and shapes) work best.

Blockwpie/live-badgeCategoryMedia

Create badge / Recreate badge

#

Exports the chosen template to SVG and stores it as the badge. The label is Create badge the first time and Recreate badge afterward; Creating… shows while it works.

InLive Badge block settings

Personalized Image (WPIE)

#

Renders a template live in the visitor's browser, replacing mapped text layers with URL parameters, so every visitor can get their own version. Pick a template, then map layers to parameters. The editor preview uses the fallback values.

Blockwpie/personalized-imageCategoryMedia

URL parameters (Parameter / Fallback text)

#

A second inspector panel listing each text layer of the chosen template with a Parameter field (the URL query key, letters/digits/underscore/dash only) and a Fallback text field shown when the parameter is absent.

InPersonalized Image block, URL parameters panel

Dynamic template (block picker)

#

The shared dropdown in each block's settings that selects which saved dynamic template the block uses. Its first option is Select a template.

Shared byall three blocks

Width (%)

#

The shared slider controlling how wide the block renders relative to its container. Present in all three blocks.

Range10 to 100Default100Unit%

Background refresh (lazy scheduler)

#

Dynamic images re-render on every save of their post, and, with Auto-refresh dynamic images enabled in the Automate dialog, on a daily schedule: while you work anywhere in wp-admin, an invisible background frame re-renders stale images. The embedded image keeps its stable URL and picks up a fresh version stamp, so it updates everywhere it is shown. Every re-bake overwrites the instance's single attachment (the previous file stays as a restorable version) - the media library never fills with copies.

Front-end shortcodes reference Pro 5 items #

The three shortcodes the dynamic-image family registers, with their attributes, for the Classic editor, Elementor's shortcode widget and any other builder.

The front-end shortcodes reference

Every dynamic block has a matching shortcode so the same designs work outside Gutenberg. All three accept a width attribute (a percentage, clamped between 10 and 100). Use the in-editor Dynamic Template Shortcodes dialog to generate them with the right ids filled in.

[wpie_dynamic_image]

#

Outputs a real, baked image filled with the embedding post's data for the given template. Until the first bake lands, the template preview shows; each post save marks the image stale so the next capable editor session re-bakes it, overwriting the same attachment for a stable URL.

Attributestemplate (template id), width (10 to 100, default 100), campaign (template id of the campaign design), campaign-from and campaign-until (dates, YYYY-MM-DD)

[wpie_live_badge]

#

Inlines a stored vector badge SVG, substituting its bound text nodes with the current post's field values on every page render. The SVG is sanitized on save (scripts, links and animation stripped) and uses the page's self-hosted fonts. Because the visitor's browser lays out the SVG text, spacing can differ slightly from the editor preview - by design, in exchange for texts that update on every view.

Attributesuid (stored badge id), width (10 to 100, default 100)

[wpie_personalized]

#

Renders a template live in the visitor's browser with per-visitor URL-parameter substitutions. Post bindings (title, prices) resolve server-side; only the mapped parameters stay dynamic client-side. Visiting ?name=Anna replaces the mapped layer with Anna.

Attributestemplate (template id), map (Layer:param:fallback entries joined by |), width (10 to 100, default 100)

map attribute format

#

The map attribute of [wpie_personalized] is a pipe-separated list; each entry is a layer name, a URL parameter and an optional fallback, separated by colons, as in map="Name:name:Guest|City:city".

EntryLayer:param:fallbackSeparator| between entries

Newsletter merge tags (personalized images)

#

The personalized shortcode reads its values from URL parameters, which makes newsletter personalization a one-liner: link your mailing to the page as ?vorname=*|FNAME|* (Mailchimp) or ?vorname={{contact.FIRSTNAME}} (Brevo) and map the layer with [wpie_personalized template="…" map="Name:vorname:Kaffeefreund"] - the mail tool substitutes its merge tag into the URL, every reader sees the graphic with their own name, and the third mapping part is the fallback for visitors without a parameter.

Dynamic Template Shortcodes: sections and states Pro 8 items #

The three shortcode sections, the copy control, badge states and empty states inside the Dynamic Template Shortcodes dialog.

The Dynamic Template Shortcodes dialog (shortcodes-dialog.jsx) hands out shortcodes for the current design so it can be used outside Gutenberg (Classic editor, Elementor's shortcode widget, any builder). These are the section framing, copy control and states not yet listed.

Live Badge (section)

#

The first card. Bakes a vector copy of the current design whose bound texts are substituted server-side as the page is served, ideal for prices and dates. That substitution lands in the page itself, so behind a full-page cache the badge is as fresh as that cached page and no fresher; editing the post refreshes both. Vector content only; pixel layers embed as static images. The badge is not a pixel-perfect copy of the editor preview: the browser lays out its text and complex layer effects are simplified - use a Dynamic Image when the embed must match the design exactly.

ChipShortcodeProduces[wpie_live_badge]

Personalized Image (section)

#

The second card. Maps text layers to URL parameters (for example ?name=Anna) and produces a shortcode that renders live in the visitor's browser. Requires the design to be saved as a dynamic template.

ChipShortcodeProduces[wpie_personalized]

Dynamic Image (section)

#

The third card. Produces a shortcode for a real baked image filled with the embedding post's data. Saves mark it stale and the next open editor session re-bakes it.

ChipShortcodeProduces[wpie_dynamic_image]

Copy

#

The button next to each read-only shortcode field. Copies the shortcode to the clipboard, showing Shortcode copied. on success or Copy blocked if the browser refuses (then select and copy by hand).

Typebutton and toasts

Baking… / Re-bake badge

#

The badge button shows Baking… while it works, then reads Re-bake badge once a badge exists. Re-bake after design changes; the shortcode itself stays the same.

First runBake badge from this design

Shortcode (chip)

#

The small chip on each section header marking it as a shortcode-producing tool.

Typeheader chip

This design has no named text layers to personalize.

#

Shown in the Personalized Image card when the saved template has no named text layers to map to URL parameters.

Typeempty state

Save this design as a dynamic template first (File, then Save as Dynamic Template)

#

Shown in the Personalized Image and Dynamic Image cards when the current document is not yet a saved template. The shortcodes reference the template id, so the design must be saved first.

Typeprerequisite note

Dynamic-image blocks: inspector options, help text and placeholders Pro 11 items #

The block-editor option values, busy labels, in-canvas placeholders and help text for the three dynamic-image Gutenberg blocks.

The Gutenberg blocks (blocks.js) put dynamic templates onto the site. Their block panels reuse the same Dynamic template picker and Width slider, but each has its own busy states, placeholders and help text documented here.

Select a template

#

The first option in the Dynamic template dropdown of every dynamic-image block. Nothing renders until a real template is chosen.

Typeempty option

Rendering…

#

The busy label on the Render now button of the Dynamic Image block while it bakes the image.

Typebutton state

Creating… / Create badge / Recreate badge

#

The Live Badge block button reads Create badge first, Creating… while it stores the SVG, and Recreate badge once a badge exists. Once created, the badge also re-bakes automatically whenever its dynamic template is updated in the editor.

Typebutton states

Pick a dynamic template in the block settings.

#

The in-canvas placeholder shown by all three blocks before a template is selected.

Typeplaceholder

Save the post (or press "Render now") to bake the image.

#

The Dynamic Image placeholder once a template is chosen but no image has been baked yet.

Typeplaceholder

Press "Create badge" in the block settings.

#

The Live Badge placeholder once a template is chosen but no badge has been created yet.

Typeplaceholder

Badge stored (%s).

#

The Live Badge placeholder after a badge is saved. The front end fills it with the post's current data (the template name is shown).

Typeplaceholder

Re-rendered automatically on every save (help)

#

The Dynamic Image panel help text: the image re-renders on every save with the post's current data, and the front end serves a real image file.

BlockDynamic Image

A vector badge, filled server-side (help)

#

The Live Badge panel help text: a vector badge whose bound texts the server fills in as the page is served, so it follows its post with no re-render, and behind a page cache it is as current as the page it sits on. Vector-only designs work best; the browser lays out the badge text, so it is close to but not pixel-identical with the editor preview - pick the Dynamic Image block for an exact copy.

BlockLive Badge

Map text layers to URL parameters (help)

#

The Personalized Image panel help text: mapping a layer to a parameter means visiting ?name=Anna replaces that layer's text live in the visitor's browser.

BlockPersonalized Image

Block descriptions

#

The one-line descriptions shown in the block inserter: Dynamic Image is a real image baked on every save; Live Badge is a vector badge substituted server-side; Personalized Image renders per visitor with URL-parameter substitutions.

CategoryMedia

Shortcode attributes and bake behavior Pro 6 items #

The attributes accepted by the three dynamic-image shortcodes and how they bake on the front end.

The shortcodes (class-blocks.php) mirror the blocks for non-Gutenberg builders. These are their attributes and the server-side bake behavior a user should know.

template (attribute)

#

Required on [wpie_dynamic_image] and [wpie_personalized]. The id of the saved dynamic template to render. Without it the shortcode outputs nothing.

Used by[wpie_dynamic_image], [wpie_personalized]

uid (attribute)

#

Required on [wpie_live_badge]. The id of the stored badge SVG created when you baked the design.

Used by[wpie_live_badge]

width (attribute)

#

Optional on all three shortcodes. The display width as a percent of the container. Values are clamped to the valid range.

Range10 to 100Default100Unit%

map (attribute)

#

Optional on [wpie_personalized]. Pipe-separated entries, each layer:param:fallback, mapping a text layer to a URL parameter with an optional fallback.

FormatLayer:param:fallback|...Used by[wpie_personalized]

Bake-on-save and stale queue

#

Every save (Classic editor, REST, WooCommerce sync, bulk edit) marks a post's dynamic images stale; the next open editor session re-bakes them. Until the first bake lands, [wpie_dynamic_image] shows the template preview. The save scan also walks Elementor (_elementor_data) and Bricks layouts; Divi shortcodes live in the content itself. Fresh entries get a short grace period so the saving editor session bakes them alone, and a registry entry whose baked attachment was deleted heals itself with a fresh file instead of retrying forever.

Applies to[wpie_dynamic_image] and the block

Live badge SVG limit

#

A baked live badge SVG is sanitized (scripts, links and animation removed) and must stay under 4 MB, otherwise storing it is rejected.

Max size4 MB

Pro starter template packs Pro 23 items #

Pro adds 1404 extra starter templates in 29 packs, 17 of which bring their own gallery category, lifting the category chips from 12 to 29.

The free editor ships 255 starter templates in 12 built-in categories. Pro registers 29 additional packs on top through the editor's extension API, for 1404 extra templates. Seventeen of them are category packs that add a brand new chip to the gallery, and the remaining twelve are top-up packs of 45 templates each that fill out the categories the free editor already has. A category pack holds 42 or 64 templates depending on its subject; the Dynamic Posts pack is the small one, with 16 designs built around post bindings.

Pro templates behave exactly like the built-in starters: they are fully editable documents, not flattened images. Clicking one opens it as a new document, in its own tab where tabs are available. Everything you find them with in the free editor keeps working, including the category chips and the color search.

The pack JSONs live in the Pro package and are fetched lazily, so nothing downloads until the gallery lists packs for the first time. The packs need Free 1.257 or newer, since that version introduced pack-declared categories. On an older free editor the packs are skipped rather than breaking the editor, so the extra templates simply do not appear.

Seasonal & Holidays

#

Category pack for seasonal and holiday posts. Adds its own chip to the gallery filter bar.

Travel & Places

#

Category pack for travel, destinations and places. Adds its own chip to the gallery filter bar.

Beauty & Wellness

#

Category pack for beauty, spa and wellness topics. Adds its own chip to the gallery filter bar.

Community & Engagement

#

Category pack for community posts and audience engagement. Adds its own chip to the gallery filter bar.

Life Moments & Cards

#

Category pack for life moments, greetings and cards. Adds its own chip to the gallery filter bar.

Gaming & Streaming

#

Category pack for gaming and streaming channels. Adds its own chip to the gallery filter bar.

Clubs & Non-Profit

#

Category pack for clubs, associations and non-profit work. Adds its own chip to the gallery filter bar.

Trades & Services

#

Category pack for trades and local service businesses. Adds its own chip to the gallery filter bar.

Real Estate & Home

#

Category pack with 44 templates for real estate listings and home topics. Adds its own chip to the gallery filter bar.

Cars & Mobility

#

Category pack with 44 templates for cars, dealerships and mobility. Adds its own chip to the gallery filter bar.

Kids & Family

#

Category pack with 44 templates for kids and family topics. Adds its own chip to the gallery filter bar.

Tech & SaaS

#

Category pack with 44 templates for tech products and SaaS. Adds its own chip to the gallery filter bar.

Finance & Insurance

#

Category pack with 44 templates for finance and insurance topics. Adds its own chip to the gallery filter bar.

Podcast & Video

#

Category pack with 44 templates for podcast episodes and video channels. Adds its own chip to the gallery filter bar.

Pets & Vets

#

Category pack with 44 templates for pets and veterinary practices. Adds its own chip to the gallery filter bar.

Fashion & Style

#

Category pack with 44 templates for fashion and style topics. Adds its own chip to the gallery filter bar.

More Starter Templates

#

The extras pack: 180 templates that do not add a category of their own. They carry the free editor's built-in category ids, 15 per category, so they top up all 12 built-in chips (Sales & Specials, Products & Launches, Events & Invites, Music & Nightlife, Food & Drink, Sports & Fitness, Business & Jobs, Tips & Courses, Quotes & Reviews, Editorial & Media, Data & Planning, Art & Posters) instead of appearing under a new one.

Starter Templates (tray)

#

In the Asset Library tray under the canvas, the Starter Templates section lists the Pro templates alongside the built-in ones. Click a tile to open that template as a new document.

Starter Templates (full dialog)

#

The Starter Templates tab of the full Asset Library dialog shows the same Pro templates with larger previews, the category chips and the color search.

Templates tab (New Image)

#

On the Templates tab of the Create New Image dialog (File, then New, and the welcome start screen), the Pro packs appear below the built-in starters and above your own saved dynamic templates.

Pack subheading

#

Each pack's templates are grouped under a subheading carrying the pack's label, the same way extension template packs are grouped, so you can see which pack a template came from.

Category chips

#

The filter bar above the template grid. All is the default; the 12 built-in chips come first and the 16 Pro category chips are appended after them, for 28 categories. Clicking the active chip again clears the filter back to All.

Lazy loading

#

Pack contents are fetched from the Pro package only when the gallery first lists packs, so the extra templates cost nothing until you open a template surface.

Elementor widgets Pro 5 items #

Dynamic Image, Live Badge and Personalized Image as native Elementor widgets - thin wrappers around the same shortcodes the Gutenberg blocks use.

Search for "WPIE" in the Elementor panel. Because the widgets render through the existing shortcodes, an Elementor update cannot break the output - worst case the widgets simply do not register. A toggle under the Widgets & Blocks tab in Settings switches the bridge on and off (default on).

WPIE Dynamic Image

#

Picks a Dynamic Template and renders its auto-baked, data-bound graphic for the current post - including the optional campaign template with a from/until window. Saving the page in Elementor marks the instance stale, so the image re-bakes with the post's fresh values - the same applies to the shortcode inside Bricks layouts and Divi content.

WPIE Live Badge

#

Renders a baked live badge by its UID (from the editor's Dynamic Template Shortcodes dialog); bound values are filled in as the page is served. It is an SVG laid out by the browser, so it looks close to but not pixel-identical with the editor design - use the Dynamic Image widget when the embed must match exactly.

WPIE Personalized Image

#

Renders a personalized image from a dynamic template. Mapping happens in repeater rows - layer, URL parameter, fallback - with layer-name suggestions read from the selected template; a legacy text field (layer:parameter:fallback entries separated by |) still works when no rows are set.

Settings toggle

#

the Widgets & Blocks tab in Settings enables or disables the widget registration. Existing pages keep working either way - the underlying shortcodes stay available.

Layer suggestions

#

With a template selected, the Personalized Image panel lists the template's text layers and offers them as autocomplete suggestions in every mapping row.