Skip to content
Get API key (opens in a new tab)

Programmatic market values

Set market, currency, and price visibility values for Cevoid UGC widgets in code.

View as Markdown (opens in a new tab)

Use programmatic market values when URL-based market detection is not enough. This is an advanced setup path. Start with Embed galleries and cards and Dynamic galleries if you have not embedded widgets yet.

Common cases:

  • one URL serves multiple markets, such as US and UK storefronts on the same path
  • visitors can change language or currency without a redirect
  • development or staging URLs do not match production market URLs

Set the market

Set data-market to the Cevoid market ID that should control widget language, product links, and default currency behavior.

<div id="cevoid-container" data-gallery="GALLERY_ID" data-market="MARKET_ID"></div>

For example, if your storefront detects an English and USD session, set data-market to the Cevoid market ID for that language and market setup.

Set currency separately

Set data-market-currency when prices and currency should come from a different market than the main data-market.

<div
  id="cevoid-container"
  data-gallery="GALLERY_ID"
  data-market="LANGUAGE_MARKET_ID"
  data-market-currency="CURRENCY_MARKET_ID"
></div>

This keeps language and product links from data-market, while price and currency come from data-market-currency.

Hide prices

Set data-hide-prices="true" when product prices should be hidden in the widget.

<div id="cevoid-container" data-gallery="GALLERY_ID" data-hide-prices="true"></div>