Skip to content

Placeholders

Prompt templates use {placeholder} syntax for values that change per call. The plugin resolves them before sending the request to OpenAI. Unknown placeholders resolve to an empty string — there is no warning, so be careful with typos.

This page lists every placeholder used by the shipped templates. Custom placeholders can be added to forks — but the placeholder only resolves if your job actually produces the value.

PlaceholderUsed byWhat it resolves to
{name}every templateProduct or category name.
{description}most generation/extraction templatesCurrent description (HTML).
{manufacturerLine}seo, content, alt-textFormatted manufacturer line, e.g. Manufacturer: Nike. Empty when no manufacturer.
{categoriesLine}seo, content, alt-textFormatted category list.
{parentLine}generate_seo.categoryParent category line.
{propertiesLine}contentExisting property assignments formatted as a single line.
{eanLine}contentFormatted EAN line.
{productNumberLine}contentFormatted SKU / product number line.
{currentDescriptionLine}generate_content.productCurrent description rendered as context for the model.
PlaceholderUsed byWhat it resolves to
{languageLabel}most templatesHuman-readable language for the call (“English”, “German”, …).
{sourceLanguage}translate, inline.translateSource language.
{targetLanguage}translate, inline.translateTarget language.
PlaceholderUsed byWhat it resolves to
{fields}translate, improve, unifyList of target fields for the call.
{targetFieldsLine}generate_content.*Comma-separated field names with metadata.
{titleMax}seoMax length for the meta title (chars).
{descMax}seoMax length for the meta description (chars).
{lengthRulesBlock}generate_content.*Composed per-field min/max length block.
{perFieldBlock}generate_content.*Per-field instructions block (format, tone, references).
PlaceholderUsed byWhat it resolves to
{sourceValues}translate, improve, unifyJSON of current field values being processed.
{sourceText}inline.translate, inline.improve, inline.unifyPlain text payload of the inline selection.
{sourceTextBlock}generate_content.*, inline.describe_from_urlUser-provided source text block (URL fetch, paste).
{sourcesBlock}inline.describe_from_urlMultiple sources composed into one block.
{sourceInstruction}generate_content.*Source mode hint (“model knowledge only”, “web search”, “url fetch”).
{formatSpec}unify, inline.unifyPlain-text format specification.
{formatSpecBlock}inline.describe_from_urlFormat spec wrapped in a structured block.
{presetInstructions}improve, inline.improveResolved preset instructions (e.g. “More concise”).
{presetInstructionsBlock}inline.describe_from_urlPreset instructions as a structured block.
{altSourceInstructions}generate_alt_text.product”Analyze the image directly” / “Use product metadata”.
PlaceholderUsed byWhat it resolves to
{availableUnitsBlock}extract_measuresList of unit names available in the shop.
{existingGroupsBlock}extract_propertiesExisting property groups + options as JSON.
{samplesLine}generate_seo.categorySample category descriptions for tone reference.
{samplesBlock} / {samples}unify_extract, meta.learn_promptSample input/output pairs for format extraction or learning.
{k}, {stageInstruction}, {listBlock}, {constraintsBlock}generate_categories.productNumber of categories to pick, the search-stage instruction, the candidate category list, and the scope-rule constraints.
{minKeywords}, {maxKeywords}generate_keywords.productLower and upper bound for the keyword count.
{sourcesBlock}generate_categories.product, generate_keywords.productThe picked source fields (name, description, manufacturer, …) composed into one block.
{host}, {path}, {pageHtml}inline.suggest_fetch_domain_configURL components and raw page HTML for the selector-suggestion meta-prompt.
PlaceholderUsed byWhat it resolves to
{productName}, {manufacturer}, {ean}, {categories}image_finder.search, image_finder.pick_imageProduct details used to build the web search and choose the best image.
{instructions}image_finder.searchYour custom search instructions from the Image Finder settings.
{count}image_finder.search, image_finder.pick_imageHow many results to return.
{resultsBlock}image_finder.searchThe web search results passed to the model.
{pagesBlock}image_finder.pick_imageThe candidate images extracted from each page.
{categoryInstruction}media_index.analyzeThe foldering strategy hint for the image.
{contextBlock}media_index.analyzeOrganisation context (categories, tags) used when grouping images.

Meta-prompts (fork wizard, learning, inline chat)

Section titled “Meta-prompts (fork wizard, learning, inline chat)”

These placeholders are used by the meta-prompts behind the fork wizard, learning, and the inline refine-instructions chat. They are not relevant for normal template editing.

PlaceholderUsed byWhat it resolves to
{taskType}meta.fork_wizard, meta.learn_promptThe task type the parent template targets.
{currentSystemPrompt} / {currentUserPrompt}fork wizardThe existing prompts of the parent template.
{currentInputBlock} / {currentOutputBlock}fork wizardMost recent input/output pair, used to ground the proposal.
{userDescription}fork wizardAdmin-provided description of the desired fork (“More technical for engineers”).
{previousProposalsBlock}fork wizardEarlier proposals during a multi-step refinement.
{refinementMessage}fork wizardLatest follow-up message in the refinement chat.
{scopeSummary}fork wizardHuman-readable summary of the fork scope.
{activeFieldsBlock}, {chatHistoryBlock}meta.fork_brainstormThe fields under discussion and the running chat history.
{taskLabel}, {taskPromptBlock}, {currentInstructions}, {lastOutputBlock}meta.refine_instructionsThe task being refined, its prompt, your current additional-instructions text and the last output.
{entityType}, {cellsBlock}, {latestUserMessage}inline.improve_chatThe record type, the text under refinement and your latest chat message.
  • Open any template’s user prompt to see exactly which placeholders it references.
  • When you fork a template you can add new placeholders to the prompt text — but the placeholder will only be resolved if the matching value is produced by the job (or by the meta-prompt for fork/learn flows). Otherwise it stays as a literal {yourPlaceholder} in the request.
  • Unknown placeholders resolve to empty strings, no warning.