Troubleshooting
Nothing appears on the product page
Work through these checks in order:
App embed: On the Dashboard, confirm the Iconic Product Comparison app embed is enabled on your live theme. Enable it in the theme editor under App embeds, then save.
Blocks on the template: In the theme editor, open your Product template and confirm both Specification table and Comparison table blocks are present if you expect both sections.
Product assignment: In the app, open Products, select the item, and confirm a specification table is chosen or assigned by rules. Confirm the table is Active in Specification table.
Comparison data: For the comparison block, confirm the product has a specification table assigned and that attributes you expect are marked Comparable. If you do not use manual Compare with, Shopify still needs to return related products for that item when you rely on the default behavior.
Test a product you know meets your assignment conditions or one you configured manually to remove guesswork.
The specification table is wrong or missing for a product
Manual override: If you previously picked a table on the product, that manual choice overrides automatic assignment conditions. Clear or change the table on the product, or adjust your expectations for automatic rules.
Inactive table: A table that is not active behaves like a draft. Activate it or assign a different table.
Conflicting rules: Two tables might match the same product through conditions. Narrow your conditions or set the product manually to the table you want.
Compare products look empty or too small
No columns or sparse rows: Confirm Comparable is on for the attributes you need. If you rely on related products and see no compare columns, your product may not have enough related items returned yet, or Maximum products to show may be very low. Adding Compare with products in the app is the best fix when automatic picks are a weak match.
Too few columns: In the theme editor, select the Comparison table block and raise Maximum products to show up to the number you need (up to twenty).
Comparable attributes: Open your specification table and confirm important attributes have Comparable turned on where you expect them in comparisons.
Metafield values do not show
Confirm you connected a product metafield, not a metafield that only exists on another Shopify resource. Verify the namespace and key, then confirm the product has a real value stored.
Ratings are missing
Ratings require data in Shopify that the Rating attribute can read. If you use a review app, confirm it writes ratings into product metafields your setup expects. No review app means there may be no rating to display.
Icon upload fails
Attribute icons must be 500 KB or smaller and should be a normal image file. Reduce image size or re-export the file, then try again.
I changed themes and tables disappeared
Each theme has its own app embed and block placement. Re-enable Iconic Product Comparison under App embeds and re-add Specification table and Comparison table blocks on the product templates in the new theme.
Online Store 2.0 requirement
This app relies on Online Store 2.0 features such as app blocks. Vintage themes or sections that cannot host app blocks will not show these app blocks on the storefront.
Product recommendations look unrelated
Shopify chooses related products using its own logic. If the automatic picks are not a good fit, use Compare with in the app to pin exact products for that item.