Aimogen ProDocumentation
Product page Support

Placeholder reference

Every %%placeholder%% available in Aimogen Pro prompt fields, grouped by category, with the contexts each one works in.

Placeholders use the form %%name%% and are replaced before the prompt is sent.

Always available#

PlaceholderContains
%%blog_title%%Site title
%%blog_name%%Site name
%%blog_description%%Site tagline
%%site_url%%Site URL
%%current_date_time%%Current date and time
%%current_date%%Current date
%%random_sentence%%A random line from Settings › Random Sentences
%%random_sentence2%%A random line from the second pool
%%custom_html%%Reusable HTML from Settings › Custom HTML
%%custom_html2%%The second HTML block
%%privacy_policy_url%%Your privacy policy URL
%%LEFTBRACE%% / %%RIGHTBRACE%%A literal { or }, for escaping spintax

Post context#

Available in content creation, the editor, the chatbot, forms and shortcodes when a post is in scope.

PlaceholderContains
%%post_title%%Post title
%%post_original_title%%The title before any modification
%%post_content%%Post content with HTML
%%post_content_plain_text%%Post content as plain text
%%post_excerpt%%Excerpt
%%post_cats%%Categories
%%post_tags%%Tags
%%post_link%% / %%post_url%%Permalink
%%post_id%%Post ID
%%post_slug%%Slug
%%post_date%%Publish date
%%post_type%%Post type
%%featured_image%%Featured image URL
%%author_name%%Author display name
%%first_content_paragraph%%First paragraph, with HTML
%%first_content_paragraph_plain_text%%First paragraph, plain
%%last_content_paragraph%%Last paragraph, with HTML
%%last_content_paragraph_plain_text%%Last paragraph, plain
%%all_categories%%Every category on the site
%%default_post_cats%%The configured default categories
%%original_post_title%%The original title
%%parent_title%% / %%parent_content%% / %%parent_excerpt%%Parent post fields

Article generation#

Available in the bulk creators and Advanced Mode.

PlaceholderContains
%%topic%%The topic being written about
%%keyword%%The keyword
%%title%%The working title
%%ai_generated_title%%The AI-generated title
%%post_title_idea%%A title idea
%%post_title_keywords%%Keywords derived from the title
%%sections%%The full section outline
%%sections_count%%Number of sections
%%current_section%%The section being written now
%%article_so_far%%Everything written so far. The key to non-repetitive sections
%%last_section_content%%The previous section
%%article_content%%The article content
%%content%%Content
%%paragraphs_per_section%%Configured paragraphs per section
%%needed_heading_count%%Required heading count
%%language%%Configured content language
%%writing_style%%Configured writing style
%%writing_tone%%Configured writing tone
%%point_of_view%%Configured point of view
%%first_hand_experience_prompt%%The first-hand experience instruction
%%related_questions_KEYWORD%%People-also-ask questions for KEYWORD
%%royalty_free_image_attribution%%Attribution text for the imported image
%%search_keywords%%The search keywords used
%%current_item%% / %%item_counter%%The item being processed
%%current_line%%The current line of a multiline input
%%example_template%%The example template

Product data#

Available in Amazon rules, Advanced Mode and the chatbot product extensions.

Base: %%product_title%%, %%product_description%%, %%product_url%%, %%aff_url%%, %%cart_url%%, %%product_cart_url%%, %%product_price%%, %%price_numeric%%, %%price_currency%%, %%product_list_price%%, %%list_price_numeric%%, %%price_with_discount_fixed%%, %%offer_price%%, %%offer_url%%, %%offer_img%%, %%product_image%%, %%product_imgs%%, %%product_images%%, %%product_images_urls%%, %%product_imgs_html%%, %%product_rating%%, %%product_star_rating%%, %%product_reviews%%, %%review_link%%, %%product_asin%%, %%product_brand%%, %%product_author%%, %%product_isbn%%, %%product_upc%%, %%product_ean%%, %%product_counter%%, %%all_product_titles%%, %%all_product_info%%, %%product_listing_ac%%.

Extended, requiring PA-API keys plus the Amazon extension: %%product_score%%, %%product_edition%%, %%product_language%%, %%product_pages_count%%, %%product_publication_date%%, %%product_contributors%%, %%product_manufacturer%%, %%product_binding%%, %%product_product_group%%, %%product_part_no%%, %%product_model%%, %%product_warranty%%, %%product_color%%, %%product_is_adult%%, %%product_dimensions%%, %%product_date%%, %%product_size%%, %%product_unit_count%%.

Video#

Available in YouTube rules and Advanced Mode.

PlaceholderContains
%%video_title%%Video title
%%video_captions%%Full caption text
%%video_caption%%A caption segment
%%video_descripton%%Video description. Note the spelling — kept for backward compatibility
%%video_url%%Video URL
%%video_id%%Video ID

User context#

Available in the chatbot, forms and front-end shortcodes.

PlaceholderContains
%%user_name%%Username
%%user_display_name%%Display name
%%user_firstname%% / %%user_lastname%%Name parts
%%user_email%%Email address
%%user_id%%User ID
%%user_role%%WordPress role
%%user_url%%Profile URL
%%user_description%%Biography
%%user_language%%Detected language
%%username%%Username
%%is_user_logged_in%%Login state
%%random_user%%A random user
%%random_new_name%%A generated name

Chatbot#

PlaceholderContains
%%conversation%%The conversation so far
%%aiomatic_query%%The current query
%%query%%The query
%%original_query%% / %%original_prompt%%The unmodified query or prompt
%%selected_text%%Text the user selected
%%participant_list%%Participants, in multi-bot chat

Comments#

Used by the AI Commenter and comment generation.

%%comment%%, %%comment_content%%, %%comment_author%%, %%comment_author_name%%, %%comment_author_email%%, %%comment_author_url%%, %%comment_id%%, %%previous_comments%%.

Taxonomy#

Used by AI taxonomy descriptions.

%%term_name%%, %%term_description%%, %%term_slug%%, %%term_id%%, %%term_taxonomy_name%%, %%term_taxonomy_id%%.

Forum#

Used by the forum creators.

%%topic_user_name%%, %%reply_user_name%%, %%participant_list%%, %%conversation%%.

Internet and search results#

Used by AI Internet Access.

PlaceholderContains
%%web_results%%The formatted search results
%%result_title%%One result title
%%result_link%%One result URL
%%result_snippet%%One result snippet
%%result_counter%%Result position
%%item_title%%, %%item_url%%, %%item_description%%, %%item_content%%, %%item_snippet%%, %%item_author%%, %%item_categories%%, %%item_counter%%, %%item_scraped_data%%Feed and scraped item fields

Media#

%%image_title%%, %%image_alt%%, %%image_caption%%, %%image_description%%, %%image_list%%, %%image_attribution%%, %%image_source_url%%, %%image_source_name%%, %%image_source_website%%, %%audio_to_text%%.

Editor keep and remove pairs#

Used by editor templates to edit part of a post:

%%post_content_to_be_kept%% / %%post_content_to_be_removed%%, %%post_plain_text_content_to_be_kept%% / %%post_plain_text_content_to_be_removed%%, %%post_title_to_be_kept%% / %%post_title_to_be_removed%%, %%post_source_to_be_kept%% / %%post_source_to_be_removed%%.

OmniBlocks#

Block output placeholders are prefix plus the block identifier. See Passing data between blocks and the block reference.

Loop and trigger placeholders: %%current_input_line%%, %%current_input_line_counter%%, %%all_input_lines%%, %%webhook_url%%, %%all_omniblock_types%%.

Spreadsheet addressing: %%xlsx_BLOCKID_ROW_COLUMN%%, %%xlsx_BLOCKID_row_ROW%%, %%xlsx_BLOCKID_column_COLUMN%%, %%xlsx_BLOCKID_row_random%%, %%xlsx_BLOCKID_row_random_check%%.

AI Forms#

Each form field ID becomes a placeholder: a field with ID topic gives %%topic%%. See AI Forms.

Custom shortcodes#

The Custom Shortcode Creator on a rule defines your own %%name%% values, optionally AI-generated. Documented in the rule as %%my_custom_shortcode%% and %%name_of_custom_shortcode%%.

Common problems#

A placeholder renders literally. It is not available in that context, or the spelling is wrong. Placeholder names are exact — note %%video_descripton%%.

A placeholder is empty. The data exists but is blank — no excerpt, no featured image, no product rating.

Content appears twice. You used %%post_content%% in an editor prompt without enabling Do Not Auto Add The Content To The AI Prompt.

Still stuck? Open a support ticket and include the diagnostics from Aimogen Pro › System & Logs › System Info.