Custom Variables
Use placeholders to inject dynamic product data and reusable text into your AI prompts.
Variables are reusable placeholders that the plugin automatically replaces with real WooCommerce product data during generation. They let one prompt work across many products while still using each product's title, SKU, categories, prices, attributes, tags, or mapped custom fields.
What are Variables?
Instead of writing "Write a description for the Blue Cotton T-Shirt," you write "Write a description for {title}." When the AI processes a product, it replaces {title} with the actual name of that product.
Built-in Variables
These variables are available to all users and are automatically populated from your WooCommerce product data.
General Variables
{language}: The output language selected in your Content Settings.{style}: The writing style selected in your Content Settings.{title}: The name of the product.
Product Data Variables
{CATEGORIES}: A list of categories the product belongs to.{ATTRIBUTES}: Technical details like size, color, material, or weight.{SKU}: The product SKU.{TAGS}: Product tags.{PRICE}: The active display price.{REGULAR_PRICE}: The standard price of the product.{SALE_PRICE}: The current sale price (if applicable).
Standard Generator Variables
The Standard Generator uses a simplified set of variables:
{title},{category},{attributes},{price}.
Custom Variables (Pro Feature)
Custom variables let you map WooCommerce fields, attributes, taxonomies, or compatible custom fields to your own prompt placeholders. This is useful when important product data lives outside the standard title/category/attribute fields.
How to Create Custom Variables:
- Go to AI Product Tools > Settings > Prompt Settings.
- Open the Variables panel.
- Click Add Variable.
- Choose the field group and field you want to map.
- Enter the variable name you want to use in prompts, such as
material_sourceormanufacturer_code. - Click Save Variable.
How to Use Custom Variables:
Once created, your custom variable appears in the Variables panel. Click it to insert the placeholder into a prompt field. It will appear as {variable_name} and will be replaced with the selected product field when generation runs.
How to Delete Custom Variables:
Click the trash icon next to the variable name in the Variables panel.
Example Use Cases
Custom variables save time when you have consistent brand elements across all descriptions:
- Manufacturer Code: Map a custom field to
{manufacturer_code}so technical prompts can mention it. - Material Source: Map an ACF or WooCommerce field to
{material_source}for sustainability-focused descriptions. - Warranty Length: Map a warranty meta field to
{warranty_length}so generated FAQs stay accurate.
Visual Indicators
In the prompt editor, variables are highlighted with colored badges. This helps you quickly see which parts of your prompt are dynamic and which are static text.
Custom variables are a great way to include product-specific data that is not part of the default prompt variables. For fixed brand rules or brand voice, use Brand Context and prompt settings instead.
What's Next?
Check out the AI Models Guide to choose the best engine for your dynamic prompts.