Prompt variables

Prompt variables let you write a single prompt template and have Vizzybl expand it into every combination automatically. Instead of typing dozens of nearly-identical prompts by hand, you write one — like Best [product] in [city] — and Vizzybl fills in the blanks using values from your brand settings.

This is the most efficient way to monitor a brand across multiple products, regions, or competitors.

Syntax

Variables use square bracket notation. Anything inside [ ] is treated as a variable name:

• Best [product] for [audience]
• How does [brand] compare to [competitor]?
• Top [product] in [city]

Variable names are case-insensitive and whitespace is trimmed, so [Product], [product], and [ product ] all refer to the same variable.

If a variable doesn't have a value defined, the bracket stays in the prompt as literal text — it won't cause an error or block monitoring, but the prompt won't expand on that variable.

Defining variable values

Variable values live in Settings > Brand. Each variable maps to an array of values:

Variable	Values
[product]	Hairdryer, Curler, Straightener
[city]	London, New York, Tokyo
[competitor]	Acme, Globex, Initech

Vizzybl pre-populates a few common variables for you during onboarding:

• [brand] — Your brand name (from your brand profile)
• [competitor] — Each competitor you've added (from Identify Your Competitors)
• [product] — Inferred from your industry and brand description

You can add any custom variable you want — [city], [audience], [use-case], etc. — and define the values that should be substituted.

How expansion works

When you save a template, Vizzybl generates the Cartesian product of all the variable values. Every variable's values are combined with every other variable's values.

Worked example

• Template: Best [product] in [city]
• [product] has 3 values: Hairdryer, Curler, Straightener
• [city] has 3 values: London, New York, Tokyo
• Result: 9 expanded prompts (3 × 3)

The first few expansions look like:

• Best Hairdryer in London
• Best Hairdryer in New York
• Best Hairdryer in Tokyo
• Best Curler in London
• … and so on

If you add a third variable with 2 values, the total becomes 3 × 3 × 2 = 18 prompts.

Resolved vs. unresolved variables

Vizzybl distinguishes between resolved and unresolved variables in a template:

• Resolved — The variable name matches one you've defined in Settings > Brand with at least one value. It will be substituted and contributes to the expansion count.
• Unresolved — No matching variable is defined, or its value list is empty. The bracket is left as literal text and does not multiply the expansion.

Use the unresolved warning in the expansion preview to catch typos like [products] (plural) versus [product] (singular) before you save.

Expansion preview

Before any template is saved, Vizzybl shows you a full expansion preview with every generated prompt. From the preview you can:

• Review the complete list of expansions
• Deselect any expansions you don't want to monitor
• See the total credit cost against your plan limit

This is your last chance to sanity-check the result before activation, so always glance through the preview before confirming.

Credits and cost implications

Each expanded prompt becomes a separate monitored prompt and consumes credits on every monitoring cycle. A template that expands into 50 prompts costs the same as 50 individually-written prompts — there's no discount for templating.

Practical guidance:

• Start with small variable sets (2-3 values each) and expand once you've confirmed monitoring is producing useful results
• Adding a single new value to one variable multiplies your prompt count by the product of all other variables' value counts
• Check Billing & Credits to see how monitored prompts map to credit consumption on your plan

Common use cases

Pattern	Template example	What it captures
Multi-product	Best [product] for beginners	One prompt per product line
Multi-region	Top [product] in [city]	Geographic visibility across markets
Competitive	[brand] vs [competitor] comparison	Head-to-head visibility for every competitor
Audience segmentation	Best [product] for [audience]	Vary persona/use-case while holding product steady
Combined	Best [product] for [audience] in [city]	Full coverage across product × audience × geography

Generating templates with variables

If you'd rather not write templates by hand, the AI chat can do it for you. The /prompts-variables command (see Generating Prompts) inspects your brand's defined variables and proposes templates that make the most of them.

Tips and best practices

Tip: Always review the expansion preview before saving. It catches bad combinations (e.g. a region you don't operate in) and lets you trim before you spend credits.

Tip: Keep variable values short and natural — they're substituted into the prompt verbatim and will be read by AI engines exactly as written. London reads better than Greater London Metro Area.

Warning: Cartesian products grow fast. 4 variables with 5 values each = 625 prompts from a single template. Combine modest variable sets and add complexity incrementally.

Next steps

• Managing Prompts — Organize, filter, and archive prompts once they're monitored
• Generating Prompts — Use the AI chat (including /prompts-variables) to author templates
• Set Up Your Brand — Where variable values are configured under Settings > Brand