Skip to main content

Personalization Macros in the Campaign Builder

A complete reference to every personalization macro available in the AIQ Campaign Builder, grouped by category.

Overview

Personalization macros are dynamic placeholders you can paste into a campaign’s message body, subject line, or template. When the message is delivered, each macro is replaced with a value pulled from the recipient’s contact record, your brand configuration, or a predictive model. Used well, macros turn a single template into thousands of one-to-one messages.

This article lists every macro currently available in the Campaign Builder’s Personalization panel, grouped by category, with a description of what each one returns.

Note: Messages won’t be sent if the required data for a macro is missing. Always provide fallback copy when using macros that depend on data that may not exist for every contact (for example, predicted top product or favorite store).

In this article, you’ll learn

  • What personalization macros are and how they work

  • How to insert a macro into a campaign

  • The full list of macros, organized by category

  • Where the underlying data for each macro is configured

  • How to troubleshoot macros that render as blank or literal text

Prerequisites

Before getting started, ensure you have:

  • A user role with access to the Campaign Manager.

    • Marketing

    • Marketing Analyst

    • Operator

    • Owner

How to use Personalization Macros

  1. Navigate to Marketing > Campaigns and open the campaign you want to edit (or create a new one).

  2. Open the Content step of the campaign.

  3. In the message editor, click Personalization to open the Personalization macro panel.

  4. Browse macros by Category, or use the search field to find a specific macro by name.

  5. Click the copy icon next to the macro you want. The macro is copied to your clipboard.

  6. Paste the macro (for example, {{firstName}}) into the message body, subject line, or template field where you want the value to appear.
    ​

  7. Save the design and continue to the next campaign step.

Warning: If required data is missing for a macro on a given contact, that contact will be skipped from the send. Always pair macros with fallback copy, or segment your audience to ensure the underlying data exists.

Available Macros by Category

The Personalization panel organizes macros into five categories: Contact, Social, General, Prediction, and Order. Each section below lists every macro in the group and describes what value it returns when the message is sent.

Contact (17)

Profile, location, and loyalty fields stored on the contact record. Most campaigns use these as the foundation of personalization.

Macro

Description

{{favoriteStore}}

The contact's favorite store.

{{favoriteStoreShopURL}}

The contact's favorite store shop URL.

{{favStoreDisclaimer}}

The favorite store disclaimer text configured for the contact's preferred store.

{{favStoreAvatar}}

The favorite store avatar (image) configured for the contact's preferred store.

{{abandonedCartLocation}}

The abandoned cart location, for "finish your checkout at {{abandonedCartLocation}}" style messages. Requires a mapped store name in Settings > Company Account > Retail Stores.

{{firstName}}

The contact's first name.

{{lastName}}

The contact's last name.

{{name}}

The contact's full name.

{{email}}

The contact's email address.

{{phone}}

The contact's phone number.

{{state}}

The contact's state.

{{city}}

The contact's city.

{{zip}}

The contact's ZIP code.

{{loyaltyPoints}}

The contact's current loyalty points balance.

{{contactID}}

The contact's unique ID.

{{totalPointsEarned}}

The contact's total loyalty points earned (lifetime).

{{totalPointsRedeemed}}

The contact's total loyalty points redeemed (lifetime).

Social (13)

Outbound links to your favorite-store profiles on social networks, review platforms, and external services.

Macro

Description

{{favoritestoreapplestore}}

The contact's favorite store Apple App Store link.

{{favoritestoregoogleplay}}

The contact's favorite store Google Play link.

{{favoritestoreinstagram}}

The contact's favorite store Instagram link.

{{favoritestoretwitter}}

The contact's favorite store Twitter (X) link.

{{favoritestoregoogle}}

The contact's favorite store Google profile link.

{{favoritestorefacebook}}

The contact's favorite store Facebook link.

{{favoritestoreyelp}}

The contact's favorite store Yelp link.

{{favoritestoreweedmaps}}

The contact's favorite store Weedmaps link.

{{favoritestoreleafly}}

The contact's favorite store Leafly link.

{{favoritestoretattle}}

The contact's favorite store Tattle (review) link.

{{landingPage}}

The text message landing page URL associated with the campaign.

{{forstaURL}}

The contact's Forsta survey URL.

{{emailOptInURL}}

The email opt-in URL for the contact.

General (11)

Campaign- and brand-level values such as your brand name, send date, and platform URLs (wallet, loyalty, opt-in/opt-out).

Macro

Description

{{brand}}

Your brand name.

{{date}}

The date the message is sent.

{{reviewWidgetURL}}

The URL to the contact's favorite store review widget.

{{walletURL}}

The URL to the contact's wallet.

{{walletURLSignup}}

The URL to the contact's wallet sign-up flow.

{{loyaltySignupURL}}

The loyalty program sign-up URL.

{{referFriendURL}}

The refer-a-friend URL.

{{tattleFeedbackURL}}

The Tattle feedback URL.

{{emailOptOutURL}}

The email opt-out (unsubscribe) URL.

{{walletPassDownloadURLApple}}

The wallet pass download URL for Apple Wallet.

{{walletPassDownloadURLGoogle}}

The wallet pass download URL for Google Wallet.

Prediction (4)

Values generated by AIQ's predictive models. Use these to recommend the next product, brand, SKU, or category each contact is most likely to engage with.

Macro

Description

{{predictedTopProduct}}

The product the contact is most likely to buy next, based on AIQ's prediction model.

{{predictedTopSku}}

The SKU the contact is most likely to buy next.

{{predictedTopBrand}}

The brand the contact is most likely to buy next.

{{predictedTopCategory}}

The product category the contact is most likely to buy next.

Order (3)

The most recent purchase a contact has made. Useful for post-purchase follow-ups and replenishment campaigns.

Macro

Description

{{lastOrderedProduct}}

The contact's most recently ordered product.

{{lastOrderedBrand}}

The brand of the contact's most recently ordered product.

{{lastOrderedCategory}}

The category of the contact's most recently ordered product.

Troubleshooting

Issue: The macro renders as blank or empty in the preview.

Solution: The underlying data is missing for that contact. Verify the field is populated on the contact record. For store-related macros, ensure a favorite store is mapped in Settings > Company Account > Retail Stores.

Issue: Contacts are being skipped from the send.

Solution: When a required macro has no value for a contact, that contact is excluded from delivery. Either segment your audience to only contacts with the required data, or rewrite the message with optional fallback copy.

Issue: A Prediction macro returns no value.

Solution: Predictive macros require sufficient purchase history for AIQ’s models to generate a recommendation. New contacts and contacts with little activity may not have predictions available.

FAQ

Can I use macros in the subject line?

Yes. Macros work in the subject line, preheader, body, and any HTML or template field that accepts text.

What happens if data is missing for a macro?

The contact is skipped from the send for that message. To avoid this, segment your audience or use macros only where the supporting data is guaranteed to exist.

Are macros case sensitive?

Yes. Always copy macros directly from the Personalization panel to preserve exact spelling and casing.

Do macros work in SMS as well as email?

Yes. Macros are channel-agnostic and can be used in Email, SMS, Push, In-App, Direct Mail, Wallet Pass, and other supported channels.

Need Help?

If you need assistance, reach out to AIQ Support anytime via the chat widget within your AIQ Dashboard.

Related Articles
Campaign Builder Overview
Wallet Pass
Voice Drops
Native Push Campaigns
Retail Stores Settings
Did this answer your question?