For the complete documentation index, see llms.txt. This page is also available as Markdown.

Customize how products display on the Trade Dashboard

Control terminology, image size, products per page, the compare-at price, the variant button text, and the product subtitle on the Trade Dashboard.

Control the wording and product details customers see on the Trade Dashboard.

Use Display to set terminology, image size, paging, compare-at pricing, the variant button text, and the product subtitle.

What these settings control

Use Display to control:

  • whether customers see Quote or Draft order language

  • how large product images appear

  • how many products load per page

  • whether compare-at pricing appears

  • the text on the variant selector button

  • which subtitle shows under each product title

Open Display settings

1

Open Trade Dashboard settings

In the Roadmap app, go to Settings → Trade Settings → Trade Dashboard.

The Trade Dashboard tab's sections run top to bottom: Header & tabs, Display, Pre-order & back-order, Filters, Quote builder, then Access. This guide covers Display.

Display settings
The Display settings in the Roadmap app.

Choose the terminology

Use Terminology to decide whether the dashboard refers to an order as a Quote or a Draft order.

Choose the term that matches how your team talks to trade customers.

Set the image size

Use Image size to control how large product images appear in the list.

  • Compact — smaller images and more products in view

  • Comfortable — larger images and easier scanning

Set products per page

Use Products per page to control how many products load on each page.

Enter a value between 5 and 200.

The default is 50.

Use a lower number for easier scanning on smaller screens.

Show the compare-at price

Turn on Show compare-at price to display the original price beside the trade price when a product has a discount or sale price.

In most setups this is the product's compare-at price. If the customer is on a catalog, it reflects that catalog's pricing context.

Use Compare-at price prefix to set the text shown before that price.

For example, use RRP.

Leave the prefix empty to fall back to RRP.

To hide the label entirely, enter a single space.

Set the variant button text

Use Variant button text to change the button shown on products with more than one variant.

The default is Configure; use your own wording, for example Select or Show variants.

The button still says Hide while the variant selector is open.

Set the product subtitle

Use Product subtitle template to control the line of text shown under each product title.

You can build the template with these variables:

  • {{vendor}}

  • {{collections}}

  • {{first_collection}}

  • {{product_type}}

  • {{catalog}}

  • {{metafield:namespace.key}}

Only text-type product metafields are supported.

Leave the template blank to hide the subtitle.

For example, {{catalog}} shows the product's catalog name under the title.

Troubleshooting

The subtitle does not show

  • Check whether Product subtitle template is blank.

  • If you use {{metafield:namespace.key}}, make sure the metafield is text-type.

The compare-at label still shows RRP

  • Leaving the prefix blank uses RRP.

  • Enter a single space if you want to hide the label entirely.

Frequently asked questions

Can I use my own product metafield in the subtitle?

Yes. Use `{{metafield:namespace.key}}`. The metafield must be a text-type product metafield.

Last updated