# Custom content for tables

## Displaying metafield content in product tables

This guide configures **Table details** for **list and table** (row) product layouts. It does **not** add those metafields to **grid** product cards. For grid versus row behavior and metafields that grid cards support out of the box, see [Metafields on product cards](/keystone/guides/products/metafields-on-product-cards.md).

Using metafields, you can display custom data within your product table. This allows for enhanced product comparisons and detailed information display. Display SKU's, product id's, or any other additional product information within the table!

Available in Keystone 1.3.0+

**Add custom data to tables via Theme settings**

{% stepper %}
{% step %}

#### Open the theme editor

In Shopify, go to Online Store > Themes and click **Customize** on the theme you want to update.
{% endstep %}

{% step %}

#### Navigate to Product cards

In the left panel, open **Theme settings > Product cards**.
{% endstep %}

{% step %}

#### Configure Table details

Scroll to the bottom to find **Table details** (Keystone 1.3.0+). Add the metafield(s) you want to display in your product tables. Supports both product and variant metafields (e.g., `custom.weight`).

To show total stock across all locations in variant tables, add the variant metafield `custom.total_inventory_all_locations` to **Table details**. Populate this metafield on each variant to display combined inventory from all locations.
{% endstep %}

{% step %}

#### Save and preview

Click **Save**, then preview a page with a product table to confirm your custom data appears.
{% endstep %}
{% endstepper %}

<figure><img src="/files/AROzToBpkwUwxfDPACa5" alt=""><figcaption></figcaption></figure>

**Create your metafields in Shopify**

{% stepper %}
{% step %}

#### Add a product metafield definition

In your Shopify admin, go to **Settings > Custom data > Products**, then click **Add definition**. For example, create a definition for **Weight** with namespace and key like `custom.weight` and choose an appropriate type (e.g., Multi-line text).
{% endstep %}

{% step %}

#### (Optional) Create a metaobject definition

If you want to manage richer structured content, create a **Metaobject** in **Settings > Custom data > Metaobjects** and relate it via a metafield.
{% endstep %}

{% step %}

#### Assign data to products

Open a product in the Shopify admin, scroll to **Metafields**, and enter values for the metafield(s) you created.
{% endstep %}
{% endstepper %}

**Display custom data in the Product Comparison section**

{% stepper %}
{% step %}

#### Add a Metafield block

In the theme editor, open a page that uses the **Product Comparison** section. Click **Add block** and select **Metafield**.
{% endstep %}

{% step %}

#### Choose which metafield to show

In the block settings, select the product or variant metafield (e.g., `custom.weight`) to display within the table.
{% endstep %}

{% step %}

#### Save

Click **Save** and verify the table shows your custom data.
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.brickspacelab.com/keystone/guides/products/custom-content-for-tables.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
