Understanding Listings
A listing groups related products and presents them as a single, organized offering with selectable options. Think of it as a smart product grouper that guides customers to the right variant.
Each listing contains:
Products from your Shopify catalog
Options that customers choose from
Display settings for presentation
Mappings that connect options to products
Creating New Listings
Quick Create Process
Navigate to Listings → Create listing
Enter a descriptive Name (e.g., "T-Shirt Color & Size Options")
Add optional Description for internal reference
Click Save to create
Adding Products
Search and Select:
Click Select products in your listing
Search by name, SKU, or collection
Select multiple products at once
Click Add selected products
💡 Pro tip: Add all color/style variations of the same product type for best results
Setting Up Options
Options are the choices customers make. When adding options:
Click Add option
The app fetches existing options from your selected products
Choose from existing Shopify options or create custom ones
Select your display type
Values auto-populate from your products
⚠️ Important: Always use existing values when available to:
Maintain filter compatibility
Prevent duplicates ("Large" vs "L")
Ensure consistency across your store
Display Types Guide
Choose how customers see and interact with options:
Display Type | Best For | Example Use |
Color Swatches | Visual color selection | Apparel, accessories |
Text Swatches | Quick size/option selection | S, M, L, XL |
Dropdown | Space-saving, many options | 20+ variants |
Image Swatches | Image-based selection | Patterns, styles |
Managing Existing Listings
Quick Actions
Edit Listing:
Click listing name → Edit details → Save
Manage Products:
Add: Select products button
Remove: Click × on product card
Manage Options:
Add: Add option button
Edit: Click option to modify
Delete: Remove option button
Reorder: Drag to rearrange
Smart Product Mapping
The app intelligently handles product-to-option connections:
Automatic Detection: Reads existing Shopify variant data
Value Matching: Links products to option combinations
Visual Mapping: Shows which products map to which options
Easy Adjustment: Click to modify mappings anytime
Example Flow:
Red T-Shirt (Size M) automatically maps to → Color: Red, Size: M
No manual data entry required
Best Practices
✅ Do:
Use descriptive listing names
Group similar products together
Reuse existing option values
Keep options logical and ordered
❌ Avoid:
Creating duplicate option values
Mixing unrelated products
Too many options (keep under 3)
Inconsistent naming conventions