Linked Products Overview
The Linked Products page is your central hub for viewing and verifying which size recommendation quiz appears on each product in your Shopify store. This powerful tool helps you validate your product linking configuration and ensure customers see the right quiz on every product.
What is the Linked Products Page?
The Linked Products page displays a comprehensive table of all products in your store, showing:
- Which quiz (if any) will appear on each product
- The status of each quiz (Active or Draft)
- Product information including images and names
- Search and filtering capabilities
- Links to edit quizzes and preview products
This page uses the same logic as your live storefront to determine quiz display, giving you an accurate preview of the customer experience.
Key Features
Real-Time Quiz Resolution
Live Quiz Matching:
- Uses the exact same algorithm as your storefront
- Considers all association types (products, collections, tags, types, vendors)
- Applies condition logic (ALL vs ANY)
- Respects priority settings and update timestamps
- Shows only ACTIVE quizzes (DRAFT quizzes are ignored)
Accurate Representation: What you see in the Linked Products page is exactly what customers will see on your live store.
Comprehensive Product Information
Product Display:
- Product thumbnail images
- Product names with links to Shopify admin
- Has Quiz indicator (Yes/No)
- Quiz status badge (Active/Draft)
- Quiz name with link to editor
- Preview button for storefront testing
Search and Filtering
Product Search:
- Search by product name
- Real-time filtering as you type
- Clear search functionality
Quiz Search:
- Search by quiz name
- Filter products by specific quiz
- Useful for validating quiz coverage
Sorting Options:
- Sort by product name (A-Z, Z-A)
- Sort by quiz status (Active, Draft, None)
- Sort by quiz name (A-Z, Z-A)
- Sort by “Has Quiz” status
Accessing the Linked Products Page
Navigation
From Main Menu:
- Open your SmartSize AI Fit Recommender dashboard
- Click “Products” in the navigation
- The page loads with all your products
From Quiz Dashboard:
- Go to “Fit Quizzes” page
- Click “All Products” in secondary actions
- Direct link to Linked Products page
Quick Access: The page is also accessible from quiz editor pages and other sections where product verification is helpful.
Understanding the Product Table
Table Columns
Product Image:
- Thumbnail of the product’s main image
- Empty placeholder for products without images
- Visual identification for quick product recognition
Product Name:
- Full product title from Shopify
- Clickable link to Shopify admin product page
- Allows quick access to product details
Has Quiz:
- “Yes” if a quiz matches the product
- “No” if no quiz matches the product
- Badge format for easy visual scanning
Quiz Status:
- “Active” for quizzes customers can see
- “Draft” for quizzes in development
- Empty for products without quizzes
- Color-coded badges (green for Active, blue for Draft)
Quiz Name:
- Name of the matching quiz
- Clickable link to quiz editor
- “-” displayed for products without quizzes
Preview:
- Button to open product in storefront
- Tests the actual customer experience
- Opens in new tab/window
Table Interactions
Sorting: Click column headers to sort by different criteria:
- Product Name: Alphabetical sorting
- Has Quiz: Group products with/without quizzes
- Quiz Status: Group by Active/Draft status
- Quiz Name: Alphabetical quiz sorting
Pagination:
- 15 products per page
- Page navigation at bottom of table
- Current page indicator
- Previous/Next buttons
Loading States:
- Skeleton placeholders while loading
- Smooth transitions between states
- Loading indicators for refresh operations
Using Search and Filters
Product Name Search
Basic Search:
Enter: "T-Shirt"
Result: Shows all products with "T-Shirt" in the name
Advanced Search Tips:
- Search is case-insensitive
- Partial matches supported
- Real-time filtering (no need to press Enter)
- Use specific terms for precise results
Quiz Name Search
Quiz-Specific Filtering:
Enter: "Women's Tops"
Result: Shows only products using "Women's Tops" quiz
Use Cases:
- Validate specific quiz coverage
- Find products using incorrect quiz
- Audit quiz assignment accuracy
- Identify products needing quiz updates
Combined Search Strategy
Comprehensive Validation:
- Search for product category (e.g., “dress”)
- Check if all results use appropriate quiz
- Search for quiz name to see all associated products
- Verify coverage matches expectations
Interpreting Quiz Assignments
Expected Assignments
Products with Quizzes:
- Products matching your association configurations
- Only ACTIVE quizzes appear
- Highest priority quiz shown for conflicts
- Most recently updated quiz wins ties
Products without Quizzes:
- Products not matching any associations
- Products only matching DRAFT quizzes
- Products where associations are misconfigured
Assignment Validation
Green Light Indicators:
- ✅ Product has “Yes” in Has Quiz column
- ✅ Quiz status shows “Active”
- ✅ Quiz name matches expected quiz for product type
- ✅ Priority system working as intended
Red Flag Indicators:
- ❌ Important product shows “No” for Has Quiz
- ❌ Product shows wrong quiz name
- ❌ Quiz status shows “Draft” when should be Active
- ❌ Inconsistent quiz assignment across similar products
Common Validation Scenarios
Scenario 1: New Quiz Validation
Process:
- Create and configure new quiz
- Set quiz status to ACTIVE
- Open Linked Products page
- Search for products that should match
- Verify quiz appears correctly
Expected Results:
- Target products show new quiz
- Quiz status displays as “Active”
- No unintended products show the quiz
Scenario 2: Priority Conflict Resolution
Process:
- Identify products showing unexpected quiz
- Note which quiz is currently displayed
- Check quiz priorities and associations
- Adjust priorities or associations
- Refresh Linked Products page to verify changes
Expected Results:
- Preferred quiz now displays
- Priority system working correctly
- No new conflicts introduced
Scenario 3: Association Coverage Audit
Process:
- Search for product category (e.g., “jeans”)
- Review quiz assignments for consistency
- Identify products without quizzes
- Check association configurations
- Update associations to improve coverage
Expected Results:
- Consistent quiz assignment across category
- Improved product coverage
- Appropriate quiz for each product type
Scenario 4: Quiz Performance Review
Process:
- Search for specific quiz name
- Review all products using that quiz
- Assess if product set makes sense
- Check for products that shouldn’t use this quiz
- Refine associations if needed
Expected Results:
- Quiz used on appropriate products only
- No surprising or incorrect assignments
- Clear and logical product grouping
Troubleshooting with Linked Products
Common Issues and Solutions
Issue: Quiz Not Appearing on Expected Products
Investigation Steps:
- Search for the specific products
- Check “Has Quiz” column shows “No”
- Verify quiz status is ACTIVE
- Review quiz associations
- Check for higher priority quiz conflicts
Solutions:
- Update quiz associations to include products
- Change quiz status from DRAFT to ACTIVE
- Adjust quiz priority if conflicts exist
- Modify condition logic (ALL vs ANY)
Issue: Wrong Quiz Appearing on Products
Investigation Steps:
- Search for affected products
- Note which quiz is currently showing
- Check the unexpected quiz’s associations
- Review priority settings
- Identify association overlaps
Solutions:
- Adjust quiz priorities appropriately
- Narrow associations on conflicting quiz
- Modify condition logic to be more specific
- Update product tags or collections
Issue: Inconsistent Quiz Coverage
Investigation Steps:
- Search for product category
- Review quiz assignments across similar products
- Identify patterns and inconsistencies
- Check product attributes (tags, collections, types, vendors)
- Review association configurations
Solutions:
- Standardize product tagging and categorization
- Update quiz associations for consistency
- Use collection-based associations for easier management
- Create additional quizzes for specific product segments
Diagnostic Workflow
Step 1: Identify the Problem
- Use search to find affected products
- Document current quiz assignments
- Note expected vs actual behavior
Step 2: Analyze Configuration
- Review quiz associations and conditions
- Check priority settings
- Examine product attributes
Step 3: Make Adjustments
- Update quiz associations
- Modify priorities
- Change condition logic
- Update product attributes if needed
Step 4: Validate Changes
- Refresh Linked Products page
- Search for affected products
- Verify corrections worked
- Check for new issues introduced
Performance and Caching
Data Refresh
Automatic Updates:
- Product data refreshes when you navigate to the page
- Quiz assignments update in real-time
- Changes to quizzes reflected immediately
Manual Refresh:
- Use “Refresh” button for latest data
- Clears cache and fetches fresh information
- Useful after making quiz changes
Cache Management:
- Product data cached for performance
- Quiz matching logic runs fresh each time
- Balances speed with accuracy
Large Catalogs
Performance Optimization:
- Pagination for stores with many products
- 15 products per page for optimal loading
- Search functionality to find specific products quickly
- Efficient caching reduces load times
Best Practices for Large Stores:
- Use search to find specific products or categories
- Focus on one product type at a time
- Use quiz search to validate specific quiz coverage
- Regular monitoring rather than full catalog review
Integration with Other Features
Quiz Editor Integration
Direct Links:
- Quiz names link directly to quiz editor
- Edit associations and settings
- Changes reflect immediately in Linked Products
Workflow Integration:
- Use Linked Products to identify needed changes
- Edit quiz in quiz editor
- Return to Linked Products to validate changes
Shopify Admin Integration
Product Links:
- Product names link to Shopify admin
- Edit product details, tags, collections
- Update product attributes to improve quiz matching
Storefront Testing:
- Preview button opens actual product page
- Test customer experience with quiz
- Verify quiz functionality in real environment
Best Practices for Using Linked Products
Regular Monitoring
Weekly Reviews:
- Check new products have appropriate quizzes
- Verify seasonal quiz updates are working
- Monitor for unexpected quiz assignments
Monthly Audits:
- Review quiz coverage across all products
- Identify products without quizzes
- Validate priority system effectiveness
- Check for opportunities to improve coverage
Systematic Validation
New Quiz Launch:
- Configure quiz associations
- Set status to ACTIVE
- Use Linked Products to verify coverage
- Test with sample products
- Monitor for unintended assignments
Association Changes:
- Make association updates
- Refresh Linked Products page
- Search for affected products
- Verify changes worked as expected
- Check for new conflicts
Team Collaboration
Shared Validation:
- Use Linked Products page for team reviews
- Share screenshots of unexpected assignments
- Collaborate on association improvements
- Document quiz coverage strategies
Training and Onboarding:
- Show new team members how to use the page
- Explain how to interpret quiz assignments
- Demonstrate troubleshooting workflows
- Establish regular monitoring practices
Next Steps
After mastering the Linked Products page:
- Configure Collection Linking - Set up your most common association type
- Master Condition Logic - Understand ALL vs ANY for precise targeting
- Optimize Priority Settings - Resolve conflicts and improve quiz hierarchy
- Monitor Quiz Performance - Track effectiveness and make improvements
The Linked Products page is your most powerful tool for validating product linking configuration. Use it regularly to ensure customers see the right quiz on every product.