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

# Comparison tables

> Compare with is the main way to get the most relevant comparisons. If it is empty, the block can still use Shopify-related products. You need a linked specification table with Comparable attributes. Adjust the maximum number of products to show up to twenty.

## **What a comparison table does**

A comparison table lines up your current product with other products in columns so shoppers can scan differences quickly. The rows come from attributes in your linked specification table that you mark as **Comparable**. Without Comparable attributes, the comparison layout has nothing meaningful to show for those rows.

## **What must be in place**

1. The product has a **specification table** assigned (by assignment rules or by your choice on the product).

2. In that table, at least some attributes are turned on as **Comparable**.

The comparison block can still run when **Compare with** is empty, using **Shopify related products** as a fallback. **Compare with** is the main part of the app for getting the best results, because you choose exactly which products appear side by side.

## **How compare products are chosen**

**Compare with in the app:** Add **Compare with** products on each product in the app for full control and the most relevant comparisons. That list is saved on the product. When it is set, those products take priority in the grid ahead of automatic related picks.

You can select **up to twenty** products in **Compare with** for a single product. That lines up with the theme block setting described below.

**When Compare with is empty:** The app compares the current product with **Shopify related products** for that product. Those are the products Shopify’s recommendation system suggests as related or complementary, so the set can change as your catalog changes.

<Tip>
  Use Compare with for tight comparisons, such as models in the same family. Related products alone are useful when you have not set Compare with yet, but hand picked products usually match your merchandising best.
</Tip>

## **Mark attributes as Comparable**

1. Open **Specification table** in the app and edit the table that applies to your products.

2. Open an attribute that should appear in comparisons.

3. Turn **Comparable** on for attributes you want in the comparison layout.

4. Save the table.

If no attributes are Comparable, comparison rows may look empty or incomplete even when products appear in the columns.

## **Set Compare with on a product**

1. Open **Products** in the app and click a product.

2. Find **Compare with** (wording may match your theme closely).

3. Browse or search and add up to **twenty** products for the strongest comparisons. You can leave this empty and rely on related products until you are ready to curate the list.

4. Save the product configuration in the app.

Leaving **Compare with** empty does **not** stop the comparison block from working when related products are available from Shopify, but adding products here is how you get the most out of the app.

## **Theme block: how many products appear**

In the theme editor, select the **Comparison table** app block. Use **Maximum products to show** to cap how many products appear in the comparison columns. You can choose a value from **1** through **20**.

This limit applies whether the columns are filled from **related products** or from your **Compare with** list.

Lowering the number keeps wide tables manageable on small screens. Raising it shows more columns when enough products are available.

<Tip>
  If you use manual Compare with and saved twenty products but the block shows fewer, check Maximum products to show first.
</Tip>

## **Design the comparison table appearance**

Comparison styling is separate from specification table styling. In the app, go to **Settings**, then use **Customize** under the comparison table card. You get preview controls, layout options, and appearance settings tuned for the comparison grid.