Swatch Image Link

👍

Welcome note

Data hub is our new upgraded platform, which we rolled out in August 2025. It offers a single unified integration for passing your data through to your Bloomreach products.

You have access to Data hub if you've implemented with Bloomreach after August 2025.

Customers who have implemented before August 2025 should follow the existing documentation for Engagement, Discovery, and Clarity.

• Display Name: Swatch Image Link

• System Name: swatch_image

• Data Type: String

• Levels: Variant

• Used By Apps: All

• Required By Apps: None

Swatch image URL for the variant.
This should be a small image showing the variant's distinguishing visual characteristic,
typically used for color, pattern, or material selection.

Value must be a valid, absolute URL pointing to an image resource.
The URL should be publicly accessible and use HTTPS protocol when possible.
Swatches are typically small, square images optimized for quick loading and clear visual
differentiation.

This attribute is only applicable at the variant level.

Product-level swatch_image is not supported

Swatches help customers quickly identify and select between variant options

This attribute is essential for variant selection interfaces, particularly for products
with color, pattern, or material variations.

General Usage

• Displaying variant selection options on product detail pages

• Creating visual variant selectors for color, pattern, or material choices

• Building accessible interfaces with visual variant differentiation

• Supporting quick variant comparison and selection

"https://cdn.example.com/products/swatches/shirt-navy-swatch-50x50.jpg"

"https://images.store.com/catalog/2024/variant_12345_swatch.webp"

"https://assets.store.com/swatches/fabric-pattern-floral-blue.png"

Application Usage

Engagement

Reserved Attribute Name: swatch_image

Used for:

• Displaying variant swatches in personalized product recommendations

• Creating dynamic email content with variant options

• Building interactive variant selection experiences in campaigns

Discovery

Reserved Attribute Name: swatch_image

Used for:

• Displaying variant swatches on product detail pages

• Creating visual variant selectors in search results

• Enhancing faceted navigation with visual options

• Supporting variant-level merchandising strategies

Feature Capabilities & Configuration

• Referenced in Delivery API request parameter as: sku_swatch_images

• Referenced in Delivery API response documents as: sku_swatch_images

• Can be faceted and filtered on in Delivery APIs?
  YES

• Available to use in Variant/SKU-select use cases?
  YES

• Available to use in facet management dashboard?
  YES

• Searchable by default?

• Facetable by default?

• Displayable by default?