Variables

Variables let you display dynamic product data — such as price, currency, and trial period — directly inside your paywall or onboarding screen.

They automatically pull real-time values from your connected stores (App Store, Google Play) through Qonversion, so your content always stays accurate without manual edits.

Using Text Variables


What You Can Do with Variables

  • Display live pricing and offer details inside Text, Heading, or Button components.
  • Localize values automatically based on the user’s store region.
  • Avoid app updates — when prices or durations change in the store, your screen updates instantly.

Accessing Variables

You can add a variable in any Text, Heading, or Button by typing or {{in the text field — or by opening the Variables picker from the right panel.

The picker shows:

  • A searchable list of all available variables.
  • Example values for each variable, pulled from your connected products.
  • Product selection dropdown (to link variables with a specific product).
📘

Tip: Make sure your products are connected in Qonversion before using variables — the picker displays only sample data

Variables Dropdown


How Variables Work

Each variable is tied to a product identifier and a specific property (like price or duration). You can insert them using the ${{}} syntax inside text or button labels:

{{products.product_id.price_per_month}} / month

When the screen loads, this will automatically show something like: $8.99 / month


Example Use Cases

Use CaseExample VariableRendered Output
Show annual price per month{{products.annual.price_per_month}} / month$8.99 / month
Show monthly price per year{{products.monthly.price_per_year}} / year$49.99 / year
Show trial info{{products.monthly.trial_period_unit_count}} {{products.monthly.trial_period_unit}}7 days
Show currency{{products.monthly.currency_symbol}}$
Show full price{{products.monthly.price}}$14.99

Variable Reference

VariableExample ValueDescription
store_nameannualInternal product name.
price$14.99Formatted current product price.
price_raw14.99Numeric price without currency.
price_per_day0.16Price per day (calculated).
price_per_week1.15Price per week (calculated).
price_per_month5.00Price per month (calculated).
price_per_year59.96Price per year (calculated).
currency_codeUSDISO currency code.
currency_symbol$Currency symbol.
period_unitmonthProduct period (e.g., week, month, year).
period_unit_count3Number of units in the billing period.
period_isoP3MISO 8601 formatted period.
trial_period_unitweekTrial period unit.
trial_period_unit_count1Trial duration count.
intro_price10.99Introductory offer price.
intro_period_unitweekUnit for introductory period.
intro_period_unit_count1Count of introductory units.

More Usage Examples

Variable

Weekly Example

Monthly Example

2 Month Example

3 Month Example

6 Month Example

Annual Example

Lifetime Example

products.product_id.store_name

Premium

Premium

Premium

Premium

Premium

Premium

Premium

products.product_id.price

$3.99

$10.99

$19.99

$28.99

$54.99

$99.99

$199.99

products.product_id.price_raw

3.99

10.99

19.99

28.99

54.99

99.99

199.99

products.product_id.price_per_day

0.57

0.37

0.33

0.32

0.30

0.27

199.99

products.product_id.price_per_week

3.99

2.75

2.50

2.41

2.29

1.92

199.99

products.product_id.price_per_month

15.96

10.99

9.99

9.66

9.17

8.33

199.99

products.product_id.price_per_year

207.48

131.88

119.94

115.96

109.98

99.99

199.99

products.product_id.currency_symbol

$

$

$

$

$

$

$

products.product_id.currency_code

USD

USD

USD

USD

USD

USD

USD

products.product_id.period_unit

week

month

month

month

month

year


products.product_id.period_unit_count

1

1

2

3

6

1


products.product_id.periodly

weekly

monthly

2 months

3 months

6 months

annually

lifetime

products.product_id.period_iso

P1W

P1M

P2M

P3M

P6M

P1Y


products.product_id.trial_period_unit

day

week

week

week

month

month


products.product_id.trial_period_unit_count

3

1

1

1

1

1


products.product_id.intro_price

$2.99

$8.99

$17.99

$25.99

$49.99

$89.99


products.product_id.intro_period_unit

day

week

week

week

month

month


products.product_id.intro_period_unit_count

3

1

1

1

1

1



Using Variables with Products

When adding variables, you can select which product context they apply to.

The dropdown in the variable picker lets you choose between:

  • Selected – the product currently selected by user interaction (e.g., via “Select Product” action).
  • Specific product ID – manually assign variables to monthly, annual, weekly, or custom product identifiers.

Best Practices

  • Always link products before using variables — otherwise, the picker won’t display sample data.
  • Use {{products.selected.price}} for global CTAs (e.g., “Continue for $4.99/month”).
  • Combine trial and price variables to create clear, conversion-oriented text.
  • Keep variables inside Text or Heading components for best layout control

Example: Dynamic Pricing Message

Get {{products.selected.trial_period_unit_count}}-day free trial,
then {{products.selected.price_per_month}}{{products.selected.currency_symbol}}/month.

Output example:

“Get 7-day free trial, then $4.99/month.”

Complex Variable Use Case