How to Set Up a Checkout Personalization or Test

Checkout Personalizations let you add product upsells or content directly to your Shopify checkout — either for all visitors or a targeted audience. If you want to test variations against each other, create a Checkout Test instead. The setup process is the same.

Step 1: Create a block

1. Go to Checkout in your Intelligems dashboard.

2. Select the block type you want to create: Upsell, Trust badges, Call out, Static image, Brand logo, Progress bar, Timer or Text only.

3. Depending on which block type you've chosen, you may need to choose a template.

Step 2: Configure your block

Configuration options vary by block type. See below for Upsells, Content (i.e. Trust badge, Call out, Static image, Brand logo or Text only) and Timers.

Upsells

General

Block Name An internal label for your reference — not visible to customers.

Location ID A unique identifier that connects this block to your Shopify checkout. Each block needs its own ID, unless you want different blocks to show in the same location without adding each ID to Shopify.

• Use lowercase letters, numbers, and hyphens only.

• Examples: trust-badge-1, warranty-callout, 3-product-upsell

• You'll need this exact ID when adding the block to Shopify.

Product recommendations

Settings Set whether to exclude out of stock items, whether to exclude products that are in the cart, and the max number of products returned.

Rules Each rule has two parts: a condition (IF) and a result (THEN SHOW). Use the + Add Rule button to add multiple rules. Rules are evaluated in order. Once a rule is met, it will stop moving forward and apply that rule.

IF — targeting type options:

Option	Description
Anything in cart	Rule applies to any cart
Specific products	Cart contains or does not contain a specific product
Products from collection	Cart contains or does not contain a product from a collection
Product with tag	Cart contains or does not contain a product with a specific tag
Cart subtotal	Cart meets a subtotal condition
Cart item count	Cart contains a set number of items

Adding multiple products, collections, or tags to one condition means any single match will trigger the rule. To require more than one condition to be true, use + AND condition. For example, in the below, we would return products that were in either the "Home page" OR "All" collection.

If we wanted to return products that were in both the "Home page" AND "All" collections, we would want to set it up as an + AND condition like the below:

THEN SHOW — targeting type options:

Option	Notes
Shopify recommendations	Uses Shopify's recommendation engine (recommended)
Specific products	Show a fixed set of products
Products from collection	Show products from a specific collection
Products with tag	Show products matching a tag

Adding multiple tags to one condition means any single match will trigger the rule. To require more than one condition to be true, use + AND condition. For example, in the below, we would return products that had either the "drinkware" OR "mug" tag.

If we wanted to return products that had both the "drinkware" AND "mug" tag, we would want to set it up as an + AND condition like the below:

Use the cart tester on the right hand side of the screen to test your rules out to confirm the expected products are being returned.

Discount Define a percentage or fixed amount off.

Styling

Heading Appears above your upsells. Leave blank to hide it. Can edit copy, typography, color and appearance.

Product Card Control how each product displays — including image size and cropping, button text, typography for the product name and price, text spacing, and colors for text, background, and buttons.

Body Set the spacing between product cards and between the heading and the cards.

Block Style the container that holds the content of your block.

• Background Color: Sets the background color for the entire block.

• Border Style: The line style for the block border.

• Border Thickness: Width of the border around the entire block.

• Corner Radius: How rounded the block corners are

• Outer Padding: Controls spacing between the block border and the content inside.

All colors and typography come from your Shopify checkout brand settings. They are not custom color pickers - you're selecting from preset colors defined in your checkout theme. You can't fully customize checkout block colors or typography because the checkout is a secure, locked environment for security and consistency, limiting changes to basic theme settings like accent colors. This is a Shopify limitation.

Content (Trust badge, Call out, Static image, Brand logo, Text only)

General

Block Name An internal label for your reference — not visible to customers.

Location ID A unique identifier that connects this block to your Shopify checkout. Each block needs its own ID, unless you want different blocks to show in the same location without adding each ID to Shopify.

• Use lowercase letters, numbers, and hyphens only.

• Examples: trust-badge-1, warranty-callout, 3-product-upsell

• You'll need this exact ID when adding the block to Shopify.

Display conditions

Display conditions let you control when a block appears, based on what's in the customer's cart.

Add a condition by selecting a targeting type from the dropdown:

Condition	What it does
Anything is in cart	Applies regardless of cart contents
Specific products	Cart contains or does not contain a specific product
Products from collection	Cart contains or does not contain a product from a collection
Product with tag	Cart contains or does not contain a product with a specific tag
Cart subtotal	Cart meets a subtotal condition (e.g. greater than $50)
Cart item count	Cart contains a set number of items
Subscription item	Cart contains or does not contain a subscription item

Combine multiple conditions using + AND Condition or + OR Condition:

• AND — all conditions must be true for the block to show

• OR — the block shows if any one of the conditions is true

Adding multiple products, collections, or tags within a single condition means any one match will trigger it.

Content & Styling

Heading Appears above your other content. Leave blank to hide it. Can edit copy, typography, color and appearance.

Badges Configure the layout, typography, colors, appearance, and content for your badges — including image position, font size and style for the title and subtitle, text alignment, and border and spacing settings. Use the "+ Add badge" button at the bottom of the badges section to add more badges. Each badge is configured independently with its own icon or image, colors, title, and subtitle.

Body Set the grid layout (rows and columns) for how badges are arranged, the alignment of the badge group on the page, and spacing between badges and between the heading and badges.

Block Style the container that holds the content of your block.

• Background Color: Sets the background color for the entire block.

• Border Style: The line style for the block border.

• Border Thickness: Width of the border around the entire block.

• Corner Radius: How rounded the block corners are

• Outer Padding: Controls spacing between the block border and the content inside.

All colors and typography come from your Shopify checkout brand settings. They are not custom color pickers - you're selecting from preset colors defined in your checkout theme. You can't fully customize checkout block colors or typography because the checkout is a secure, locked environment for security and consistency, limiting changes to basic theme settings like accent colors. This is a Shopify limitation.

Progress bars

Currency

Thresholds are set in this currency, and the Personalization or Test will only target buyers shopping in this currency. This is set to your store's default currency by default, but can be edited.

General

Block Name An internal label for your reference — not visible to customers.

Location ID A unique identifier that connects this block to your Shopify checkout. Each block needs its own ID, unless you want different blocks to show in the same location without adding each ID to Shopify.

• Use lowercase letters, numbers, and hyphens only.

• Examples: trust-badge-1, warranty-callout, 3-product-upsell

• You'll need this exact ID when adding the block to Shopify.

Display conditions

Display conditions let you control when a block appears, based on what's in the customer's cart.

Add a condition by selecting a targeting type from the dropdown:

Condition	What it does
Anything is in cart	Applies regardless of cart contents
Specific products	Cart contains or does not contain a specific product
Products from collection	Cart contains or does not contain a product from a collection
Product with tag	Cart contains or does not contain a product with a specific tag
Cart subtotal	Cart meets a subtotal condition (e.g. greater than $50)
Cart item count	Cart contains a set number of items
Subscription item	Cart contains or does not contain a subscription item

Combine multiple conditions using + AND Condition or + OR Condition:

• AND — all conditions must be true for the block to show

• OR — the block shows if any one of the conditions is true

Adding multiple products, collections, or tags within a single condition means any one match will trigger it.

Content & Styling

Heading Appears above your progress bar. Leave blank to hide it. Can edit copy, typography, color and appearance.

Reward tiers Define the threshold and messaging for both the in progress and unlocked state. Can add up to five tiers.

Progress bar Set the bar color, as well as the message size, style, color and alignment.

Body Set the spacing between the progress bar and text fields.

Block Style the container that holds the content of your block.

• Background Color: Sets the background color for the entire block.

• Border Style: The line style for the block border.

• Border Thickness: Width of the border around the entire block.

• Corner Radius: How rounded the block corners are

• Outer Padding: Controls spacing between the block border and the content inside.

All colors and typography come from your Shopify checkout brand settings. They are not custom color pickers - you're selecting from preset colors defined in your checkout theme. You can't fully customize checkout block colors or typography because the checkout is a secure, locked environment for security and consistency, limiting changes to basic theme settings like accent colors. This is a Shopify limitation.

Timers

General

Block Name An internal label for your reference — not visible to customers.

Location ID A unique identifier that connects this block to your Shopify checkout. Each block needs its own ID, unless you want different blocks to show in the same location without adding each ID to Shopify.

• Use lowercase letters, numbers, and hyphens only.

• Examples: trust-badge-1, warranty-callout, 3-product-upsell

• You'll need this exact ID when adding the block to Shopify.

Display conditions

Display conditions let you control when a block appears, based on what's in the customer's cart.

Add a condition by selecting a targeting type from the dropdown:

Condition	What it does
Anything is in cart	Applies regardless of cart contents
Specific products	Cart contains or does not contain a specific product
Products from collection	Cart contains or does not contain a product from a collection
Product with tag	Cart contains or does not contain a product with a specific tag
Cart subtotal	Cart meets a subtotal condition (e.g. greater than $50)
Cart item count	Cart contains a set number of items
Subscription item	Cart contains or does not contain a subscription item

Combine multiple conditions using + AND Condition or + OR Condition:

• AND — all conditions must be true for the block to show

• OR — the block shows if any one of the conditions is true

Adding multiple products, collections, or tags within a single condition means any one match will trigger it.

Content & Styling

Timer Mode Controls how the countdown is calculated.

• Countdown to fixed date/time: Counts down to a specific moment for every visitor. Best for hard deadlines and defined sale end times. Requires an end date & time, which will be defined in your store's time zone.

• Per-visitor countdown: Counts down from a set duration that starts when each visitor loads the checkout. Best for cart-hold timers and personalized discount windows. Requires a duration in minutes.

Headline or Countdown text Appears above or alongside the timer. Leave blank to hide it. The label for this field may vary depending on your template. Can edit copy, typography, color and appearance.

When Timer Expires Controls what happens to the block after the countdown reaches zero.

• Remove the block: Hides the timer entirely once it expires.

• Show expired text: Replaces the timer with a custom message.

Expired Text The message shown after the timer reaches zero. Only shown when "Show expired text" is selected.

Expired Background Color / Expired Text Color Style the expired state message independently from the active timer.

Typography Control the font size, font style, and text alignment of the timer label and headline. Set the text color under Color.

Timer Display Only for digital clock block.

• Units Shown Choose which time units are visible on the timer — Days, Hours, Minutes, and/or Seconds.

• Style Controls the visual format of the timer digits.

  • Separator: The character or style used between time units.

  • Digit Size: Controls the size of the countdown numbers.

  • Digit Color Sets the color of the countdown digits.

Block Style the container that holds the content of your block.

• Background Color: Sets the background color for the entire block.

• Border Style: The line style for the block border.

• Border Thickness: Width of the border around the entire block.

• Corner Radius: How rounded the block corners are

• Outer Padding: Controls spacing between the block border and the content inside.

All colors and typography come from your Shopify checkout brand settings. They are not custom color pickers - you're selecting from preset colors defined in your checkout theme. You can't fully customize checkout block colors or typography because the checkout is a secure, locked environment for security and consistency, limiting changes to basic theme settings like accent colors. This is a Shopify limitation.

Step 3: Preview your block

As you make changes, the preview pane on the right updates in real-time to show how your block will appear on checkout:

• Review the overall layout and spacing

• Check that colors match your brand

• Verify text is readable and properly sized

• Ensure icons are positioned correctly

The preview shows your block in the Intelligems interface. The final appearance on your Shopify checkout may have slight variations based on your checkout theme settings.

Step 4: Save and choose your setup type

Click Next when you're satisfied with your design. Choose one:

• Complete checkout setup — show this block as a Personalization to all visitors or a targeted audience

• Create a checkout test — run multiple variations against each other

Step 5: Add the block to Shopify checkout

This step is required. The block won't appear on your checkout until it's added in Shopify.

1. Copy the Location ID from Intelligems (shown in the configuration instructions)

2. In Shopify Admin, go to Settings → Checkout

3. Under Configurations, click Customize to open the Checkout editor

4. In the top panel, click Apps

5. Navigate to Intelligems, click (+), and choose Checkout

6. Toggle on Include block in Shop Pay (recommended).

7. Paste your block Location ID into the block settings

8. Drag the block into the position you want in checkout

9. Click Save in the top right corner

Important: Each Checkout Personalization needs to be added to your Shopify checkout separately using its unique Block ID. Without this step, the block won't appear on your checkout page.

Once this step is completed, you can preview your Checkout Personalization or Test on your live website by going to the Preview tab → selecting Open Full Screen Preview.

Step 6: Set up targeting if needed

Targeting is an optional step. By default, a visitor will be immediately assigned to your Checkout Personalization or one of the test groups, but you can control who sees your Checkout Expierences using targeting rules. There are a few different ways you can do this:

• You can set up currency and country targeting that allows you to limit your Experience to a single currency and/or a list of specific countries.

• You can use UTM parameters to customize your user experience under the Audience option.

• You can filter traffic based on JavaScript Expressions under the Audience option.

• You can filter traffic based on device type (i.e. mobile or desktop) under the Audience option.

• You can filter traffic based off of whether a visitor is new or returning under the Audience option.

• You can prevent users from being targeted by related experiments to reduce undesired interactions under the Mutually Exclusive Tests option.

When to use targeting for Checkout:

• Test blocks with specific customer segments first

• Show different messages to different regions

• Display country-specific guarantees or policies

• Limit to specific marketing campaigns

• Show different upsells on different devices

You can learn more about targeting here!

What happens next?

Now that you've created your Checkout Personalization or Test, you can QA using this checklist!