How to Troubleshoot and Ensure Size Charts Display Correctly Across All Products in Staytuned
Size charts are essential for providing customers with accurate sizing information, but issues can arise when they fail to display correctly across all products. This guide outlines common problems, troubleshooting steps, and best practices to ensure your size charts function as intended.
Additionally, understanding the foundational setup process is crucial for ensuring that size charts are correctly created and assigned to products, collections, or variants.
Overview of Creating and Assigning Size Charts
Before troubleshooting, it is important to understand how to create and assign size charts. Kiwi allows you to design charts of unlimited size tailored to specific products, collections, or variants. Charts can be reused across multiple products, and the app automatically displays the most relevant chart based on matching conditions. Common Display Problems and Their Causes
Size Chart Not Displaying on Some Products - This can occur if the size chart is not correctly associated with the product options in your app settings. Each product option may need to be individually targeted.
Multiple Size Charts Not Appearing on a Product Page - If you have tagged a product with multiple size chart tags (e.g., N3142 and NB3142), ensure that all tags are correctly matched to the product. A mismatch in the tags can prevent the size charts from appearing.
Size Chart Button Missing for a Specific Product - This issue often arises due to incorrect matching conditions. Ensure that the rules (e.g., product, collection, tags, handle, vendor, or variants) include the affected product.
Size Chart Not Showing on Any Product - Common causes include the Kiwi Theme Helper/app block not being enabled or an old theme snippet conflicting with the app.
Ensure that the matching conditions are correctly configured to display the appropriate size chart for each product or variant.
Step-by-Step Troubleshooting Guide
1. Verify App Block Settings
Ensure the Kiwi Theme Helper (app block) is enabled in your theme editor.
Navigate to Shopify > Online Store > Themes > Customize.
Use the template selector to open each product template in use (e.g., default product, special product layouts).
Add or enable the Kiwi Size Chart (Kiwi Theme Helper) app block in the product page section for each template.
Save each template. Products assigned to those templates will then display the size chart.
2. Check Matching Conditions
Review the size chart’s matching conditions for the affected product.
Ensure the rules (e.g., product, collection, tags, handle, vendor, or variants) correctly include the product.
Update the condition to match the product, save, and refresh the page.
3. Resolve Tag Mismatches
If multiple size charts are not appearing, review your matching conditions and ensure all relevant tags are correctly associated with the intended product.
4. Remove Conflicting Snippets
Remove any legacy or custom “old size chart” snippets that may override the app output.
Review your injector settings and ensure the CSS selector targets an element that exists on the product page.
Best Practices for Future Configurations
Enable the Kiwi App in Your Theme - Ensure the Kiwi app is enabled in the app block section of your store theme. For detailed steps, refer to the Kiwi setup guide.
Use Swatch King for Product Options - Add any new product option as a target in the app and assign the size chart to that option accordingly. This ensures the size chart appears correctly for each product.
Reposition the Size Chart - If needed, use Swatch King to reposition the size chart on your product page.
Review Setup Steps for New Products - Whenever you add new products, review the setup steps to prevent display issues.
Understand Plan Limitations - On the Free plan, you can publish up to 2 size charts. To publish more, consider upgrading to a paid plan.
Reuse Size Charts Across Products - Create size charts that can be reused across multiple products, collections, or variants to save time and ensure consistency.
By following these steps and best practices, you can ensure that your size charts display correctly across all products, providing a seamless shopping experience for your customers.