Skip to main content

Widget Overrides

Customize widget appearance when specific Data Rule conditions are met

Tom Nipravsky avatar
Written by Tom Nipravsky
Updated over a month ago

Widget Overrides let you change how your widget looks when a specific Data Rule is triggered. This enables dynamic, context-aware messaging that adapts to your customer's situation.

What Are Widget Overrides?

While Data Rule conditions determine when to show products and actions determine which products to show, Widget Overrides change how the widget appears for that rule.

Example:

  • Condition: Customer is logged in + Total spent > $500

  • Actions: Use Recommender: Recommended for You

  • Widget Overrides: Title: "VIP Picks Just for You", Subtitle: "Exclusive selections for our valued customers"

When a VIP customer views the widget, they see personalized messaging instead of the generic title.

Available Overrides

Override

Description

Example

Title

Replace the widget's heading text

"VIP Exclusive Picks" for VIP customers

Subtitle

Replace the widget's subtitle text

"Selected just for you" for returning visitors

Add to Cart Button

Change the primary button text

"Add to Bundle" when showing bundle upsells

added to Cart Button

Change the confirmation button text

"Added to Bundle!" after item is added

Adding Widget Overrides

  1. Open a Data Rule in the rule editor

  2. Scroll to the Widget Overrides section

  3. Click Add Override

  4. Select the override type (Title, Subtitle, etc.)

  5. Enter the replacement text

  6. Click Save Changes

You can add multiple overrides to a single rule. All overrides will apply when the rule's conditions are met.

Dynamic Tags

You can use dynamic tags in your override text to personalize messaging with real data:

Tag

Description

Example Output

{product.title}

The current product's title

"iPhone 17 Pro"

{customer.first_name}

Logged-in customer's first name

"Sarah

{customer.last_name}

Logged-in customer's last name

"Johnson"

Examples

Override Text

Display Result

Complete your {product.title}

"Complete your iPhone 17 Pro"

Hi {customer.first_name}, you might like these

"Hi Sarah, you might like these"

Accessories for your {product.title}

"Accessories for your iPhone 17 Pro"

Note: If the data isn't available (e.g., customer is not logged in), the tag is replaced with an empty string.

How Overrides Work with Multiple Rules

When you have multiple Data Rules connected to a widget, they're evaluated top to bottom. The first rule whose conditions are met will apply, and its widget overrides will be used.

Example Setup:

  • Rule 1: VIP customers → Title: "VIP Picks"

  • Rule 2: Returning visitors → Title: "Welcome Back"

  • Rule 3: Default (no conditions) → Title: "Recommended"

Results:

  • A VIP customer who is also a returning visitor sees "VIP Picks" (Rule 1 matches first)

  • A returning non-VIP customer sees "Welcome Back" (Rule 2)

  • A new visitor sees "Recommended" (Rule 3, the default)

Troubleshooting

Override Not Showing

  • Verify the rule's conditions are being met

  • Check rule priority—a higher-priority rule may be matching first

  • Ensure the override text field isn't empty

Wrong Override Appearing

  • Check the order of your rules—rules are evaluated top to bottom

  • A more general rule may be matching before your specific rule

  • Reorder rules so more specific conditions are evaluated first

Did this answer your question?