This guide helps you build channel listings from existing product variants. Learn through interactive tutorials, practical how-to guides, detailed explanations, and a comprehensive reference.

🧪 Tutorials

Build Listings for a Channel

Goal: Publish a subset of product variants to a specific channel with channel-specific content.

Scenario: You have already built product variants and want to publish them to a channel.

Steps:

1. Open the Product Catalog and filter to the variants you plan to publish.
2. Select the target variants (parent- or variant-level selection is supported).
3. Click Create Listings (top-right) to open the flyout.

×

4. In the flyout, select the Channel and the Mapping Template (default is pre-filled).
5. (Optional) Review the recommendation to link after building.
6. Click Create Listings to start the background process.

×

Guided Tutorial

🛠️ How-to Guides

A. Create or Choose a Mapping Template

You already have a default Mapping Template when you click Create Listings. To manage templates directly:

Settings → Mapping → Templates → Builders → Listing Builder

• Click Generate Default Template or create one manually.
• The template controls how product variant data flows into listing fields for the channel.

B. Choose Product Variants

From Product Catalog, select individual variants or filter for a bulk selection.

C. Build Listings

1. Select variants in Product Catalog.
2. Click Create Listings.
3. In the flyout, choose Channel and Mapping Template, then Create Listings.

• Each channel uses the most recent Mapping Template you applied; first time uses the default.

D. Rebuild Listings

Rebuild to overwrite existing listing content with updated product data or different priorities.

1. Open Channel Listings and select listing variants.
2. Choose Actions → Re-Build.
3. Select whether to reuse previous templates or choose a new Mapping Template.
4. (Optional) Also rebuild parents when starting from the Variants view.

×

E. Stop Building

Remove items stuck in “Building” state for a specific channel.

1. From Product Catalog, select the parent or variant.
2. Click Actions → Stop Building.
3. Select the channel in the dropdown.
4. Click Remove From Queue and confirm Yes.

×

Guided Tutorials

🔍 Explanation

What Are Listings?

Listings are channel-specific records built from product variants. Building listings lets you:

• Choose subsets of variants per channel.
• Apply channel-specific content and transformations.
• Create a static snapshot that won’t change immediately if the product data changes later (unless you rebuild).

Mapping Templates & Linking

• Mapping Templates transform product data into listing fields required by the channel.
• When building listings, the most recent template used on that channel is applied; first-time builds use the default template.
• After building, you can link the listings as a next step to sync with the channel.

Multi-Channel Build Behavior

Building across multiple channels finishes per channel. Status remains Building until all selected channels complete, then becomes Linked to All Channels.

📚 Reference

Required Inputs (Create Listings)

Build Statuses

Rebuild Options

• Reuse each listing’s original mapping template.
• Choose a different mapping template for updated field priorities.
• Include parent listings when starting from Variants view.