> ## 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.
# Specification tables
> Learn how specification tables work in Iconic Product Comparison: create a table, set assignment conditions, organize groups and attributes, upload optional icons, and keep your storefront data clear and consistent.
## **What is a specification table?**
A specification table is a reusable set of product attributes grouped for display on the product page. You define the structure once, then connect it to products either automatically through assignment conditions or manually on each product.
## **Open the specification tables list**
1. In Shopify admin, open **Iconic Product Comparison**.
2. In the app sidebar, click **Specification table**.
You see a list of your tables with search, status, and how many attributes each table uses. Use the **Add specification table** when you want a new table.
## **Create a new table**
1. Click **Add specification table**.
2. Choose one of the following:
* **Use the default template** to start from a ready-made, Amazon-style baseline with common attributes already grouped.
* **Start from scratch** to build groups and attributes yourself.
The default template is a fast way to go live. Starting from scratch gives you a blank canvas if you already know your structure.
## **Name your table and set visibility**
On the table details page, give the table an internal **Name** you will recognize in the admin. Turn **Active** on when you want this table available for matching products. If a table is not active, treat it as a draft until you are ready.
Use **Save** when you finish a set of edits.
## **Set assignment conditions**
Assignment conditions decide which products receive this table automatically when you do not choose a table manually on the product.
1. Find the assignment section on the table details page.
2. Choose whether **all** conditions must match or **any** condition may match.
3. Click **Add condition** to build rules using fields such as product category, product type, tags, collection, or vendor.
4. Pick an operator where offered, for example **Equals**, **Does not equal**, or **Contains**, depending on the field.
5. Enter or pick the value for each condition.
If you assign a specification table directly on a product, that manual choice overrides these assignment conditions for that product. Automatic rules will not replace your manual choice.
## **Organize groups and attributes**
Specification tables use **groups** to cluster related attributes. Within each group you add **attributes** that pull data from Shopify or from metafields.
1. Use **Add group** to create a section heading shoppers will see, such as General or Dimensions.
2. Use **Add attribute** inside a group to pick what to show.
3. Drag groups and attributes to reorder them.
### **Types of attributes you can add**
When you add an attribute, you choose a data type. The picker is organized by category. Available options include the following.
**Product information**
* Product option
* Type
* Product type
* Product category
* Vendor
* Description
* Price
* SKU
* Barcode
* Rating
* Weight
* Collections
* Tags
**Reference**
* Metafield reference
* Metaobject
**Text**
* Single-line text
* Multi-line text
**Measurement**
* Dimension
* Volume
* Weight (measurement)
**Number**
* Integer
* Decimal
**Other**
* Color
* True or false
* File (PDF, specification sheet, and similar)
* Link
* Money
* Date
Product metafields from any namespace are supported when you connect metafield-based attributes. The app reads **product** metafields. It does not read metafields that belong only to customers, orders, or other resources.
## **Edit an attribute in detail**
After you add an attribute, open it to customize how it appears.
* **Name** is the customer-facing label. Changing it only changes the label, not the underlying Shopify field.
* **Tooltip** adds optional helper text for shoppers.
* **Icon** lets you upload a small image next to the attribute. Uploads must be **500 KB** or smaller. Common image formats are accepted.
* **Comparable** marks whether this attribute should appear in comparison views when you use comparison features that rely on comparable attributes.
If an icon upload fails, shrink the file under 500 KB and confirm the file is a normal image type.
## **Ratings and review apps**
If you add a **Rating** attribute, it uses rating data stored on the product in Shopify. Review apps such as Judge.me or Loox often write ratings into product metafields. If ratings are empty, confirm your review app is saving ratings where Shopify product metafields can read them.
## **Edit or remove a table**
Use the actions on the table details page to **Delete table** when you no longer need it. Consider turning **Active** off first if you want to pause a table without deleting its definition.