> ## Documentation Index
> Fetch the complete documentation index at: https://product-comparison-docs.geticonicapps.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Tables missing on the storefront usually trace back to the app embed, theme blocks, product assignment, or missing Comparable attributes. Compare with is the main way to control comparisons; related products can still appear when Compare with is empty.

## **Nothing appears on the product page**

Work through these checks in order:

1. **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.

2. **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.

3. **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**.

4. **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.

<Tip>
  Test a product you know meets your assignment conditions or one you configured manually to remove guesswork.
</Tip>

## **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.