Skip to content

Enable merchandising for an index

Background

Merchandising allows customers to define rules that change search results via the Console.

Each index has its own merchandising rules, and needs merchandising enabled per-index.

Note that new ecommerce indexes (as of December 5, 2025) have merchandising enabled on creation.

Process

Update Feature Flags

  1. Get the customer account’s system account ID (e.g. from Polo > Accounts)
  2. Add the system account ID to https://github.com/marqo-ai/cloud_control_plane/blob/main/components/feature_flags/prod/feature_flags.json#L69. Specifically add to the exception list for merchandising_ui and, if they need merchandising for search as well, the merchandising_search.

Create Configuration

  1. Use Escalator: Self-Service Admin to get admin access to the production Controller account.
  2. Go to the prod-MerchandisingTable, explore items, and find a record where the pk is a simple system account ID string (and sk is CONFIG#<index name> ).

  3. Select the record and choose Actions > Duplicate item, then change the following values to match the target index that you’re enabling for:

    1. pk = system account ID
    2. sk = CONFIG#<index name>
    3. indexUrl = <the data plane index URL, ending in .dp1.marqo.ai)

    image.png

    image.png

  4. If you like, you can also update the createdAt and updatedAt fields.