How to Use Variables for Dynamic Free Gift Widgets in Kite

This guide explains how to use variables to automatically display dynamic information—like product names or required amounts—in your campaign widgets.

What are Variables and Why Use Them?

Variables are placeholders (e.g., {{free_gift_product_title}}) that you can insert into your widget's text fields. The app automatically replaces these placeholders with the correct, up-to-date information from your campaign settings.

The main benefit is efficiency: if you change your promotion later (e.g., update the free gift from a "Gift Card" to a "T-Shirt"), the widget text will update automatically. You won't need to manually edit it.

How to Use Variables in the Widget Editor

1. Open the Widget Editor

• • While creating or editing a promotion, such as a Free Gift with Purchase, click on "edit and style widget".

2. Find the Variables List

• • Inside the editor, locate and click on the "Variables" button or link. This will reveal a list of all available placeholders for that campaign type.

3. Copy and Paste the Variable

• • Find the variable you need. For example, to show the name of the free gift, copy the variable for the free gift product title.
  • Paste the complete variable (including the curly braces {{ }}) into the desired text field, such as the widget's Title or Subtitle.

4. Combine with Other Variables (Optional)

• • You can use multiple variables. For instance, in the subtitle, you could write: "Spend {{remaining_amount}} more to unlock your gift!"

5. Save Your Changes

• • Click Save in the widget editor to apply your dynamic text.

Example: Static vs. Dynamic Text

• Static Text (Before): You manually type "Get a free Gift Card!" into the title. If you change the gift, you must edit this text again.
• Dynamic Text (After): You enter "Get a free {{free_gift_product_title}}!" into the title. Now, the widget will always show the correct name of the currently selected free gift product.

Updated on: 03/09/2025