---
title: Troubleshoot common CMH issues
slug: pbka6372
canonical_url: https://docs.coveo.com/en/pbka6372/
collection: coveo-merchandising-hub
source_format: adoc
---
# Troubleshoot common CMH issues
This article provides solutions to common issues you might encounter while using the [Coveo Merchandising Hub (CMH)](https://docs.coveo.com/en/o5290573/).

## Product attributes missing from rule creation interface

**Issue**

When configuring merchandising rules in the CMH (for example, ranking rules, filters, or synonyms), some product attributes may not appear in the attribute dropdown menu, even though they were [indexed](https://docs.coveo.com/en/204/) in your product source.

**Cause**

In the CMH, selectable attributes are scoped from the source's products.
This means that it doesn't display all [fields](https://docs.coveo.com/en/200/) across the entire organization but only those detected in the products associated with the product source.

**Resolution**

If you notice that a specific attribute is missing when creating rules, and you know it's indexed in your source, [map the corresponding metadata to a Coveo field](https://docs.coveo.com/en/1640/) to ensure that it's recognized.

## Product listing page product count discrepancy

**Issue**

There's a discrepancy between the following:

* The number of products shown on the Product Listing Page (PLP) (for example, 13 items).

* The number displayed under the **Products** metric (for example, 0 items) for the same listing page in the Product listing manager in the CMH.

**Cause**

This is expected behavior.
The **Products** metric in the CMH is generated from [Coveo Analytics data](https://docs.coveo.com/en/259/).
If no requests have been recorded for the listing page, the metric may temporarily display 0 products even though the PLP contains items.

**Resolution**

To update the product count, access the listing page directly in your storefront.
This action triggers an event associated with the page.
After an hour or two, the **Products** metric should reflect the accurate product count shown on the PLP.

## Product images visible in preview but not in metrics

**Issue**

In the CMH, product images may be visible in the **Preview** tab of a search term, PLP, or recommendation slot, but fail to appear in the **Product metrics** section.

**Cause**

The inconsistency is due to the different product resolution mechanisms used by the CMH's preview and metrics:

* The CMH preview pulls product data directly from the product source, using data contained in the `ec_thumbnails` field.

* The metrics section resolves products via the `ec_product_id` configured in the [catalog configuration](https://docs.coveo.com/en/l5if0520/).

If the unique identifier selected in your catalog configuration to map to the `ec_product_id` field doesn't match the value mapped to `permanentid` in your source, the metrics endpoint is unable to resolve the product properly.
As a result, the product's metadata can't be retrieved, even though it exists and is correctly indexed.

**Resolution**

To resolve the issue, ensure that the unique identifier configured in your catalog configuration matches the field mapped to `permanentid` in your source.

. Review the catalog configuration:

.. Access the [**Catalogs**](https://platform.cloud.coveo.com/admin/#/orgid/commerce/catalogs/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/commerce/catalogs/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/commerce/catalogs/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/commerce/catalogs/)) page of the Coveo Administration Console, and then select the desired [catalog entity](https://docs.coveo.com/en/3143/).

.. Under **Configuration**, open your [catalog configuration](https://docs.coveo.com/en/l5if0520/).

.. On the **Standard fields** tab, ensure that the metadata key that uniquely identifies products is correctly associated with the `ec_product_id` field.

. Align source mappings:

.. Access the [**Sources**](https://platform.cloud.coveo.com/admin/#/orgid/content/sources/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/content/sources/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/content/sources/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/content/sources/)) page of the Coveo Administration Console, and then click the source indexing your product data.

.. In the Action bar, click **Mappings**.

.. Under **Field**, locate `permanentid` and verify which metadata key is mapped to it.
The metadata key mapped to `permanentid` must match the unique identifier selected in your catalog configuration to map to `ec_product_id`.
If there's a mismatch, [map](https://docs.coveo.com/en/1640/) the [metadata](https://docs.coveo.com/en/218/) key to the `permanentid` [field](https://docs.coveo.com/en/200/).

See [Map commerce fields](https://docs.coveo.com/en/n8of7021/) for a complete guide on field mappings in the context of Coveo for Commerce.