Skip to content
Operator handbook
External Market Places
Hygraph
Sign in
Hygraph

External Marketplaces

Logos for other shops, such as Amazon or Bol, can be configured to appear under the buy box on the product page. They are configured on the Product model on the field External marketplace urls.

External Marketplaces fields

When configured, they appear underneath the Buybox on PDP:

External Marketplaces

Clicking on each logo opens in a new tab. The marketplace configuration lives on the Product model; there is no separate marketplace model. The pictures are Static Images.

Static word for external marketplaces

When they show

Whether the filled-in links appear on a shop depends on a storefront-specific configuration. Look that up on the StorefrontConfig field on the Settings model. Each shop uses one of three behaviours:

  • Always — Configured links will show
  • Never — Configured links will not show
  • Only when the product is out of stock — Configured links only show if that product is out of stock

They also stay hidden when the product is listed under Not sold in countries. See Products.

See example config in the Settings model for VitaminExpress:

marketplace display config

How to configure the Marketplace URL's

On the Product, use External marketplace urls. The field is localized: each locale has its own list, and an empty locale does not fall back to another language. Add one line per marketplace.

Write the line as [Amazon]https://www.amazon.de/…: the name in brackets, then the product URL. A space after ] is fine. The bracket has to be at the start of the line. A line with no URL, or with the bracket somewhere else, is skipped.

marketplace URL of product in marketplace

The name in brackets is matched to a Static Image key: marketplace_ plus that name in lowercase. [Amazon] needs the key marketplace_amazon. Capital letters in the brackets do not matter. A wrong key, or a missing image, skips that line.

For a new marketplace, create a Static Image with that key and include the shop in its Storefront list. How to fill in Key, Image, Alt, and Storefront is covered in Static Images. The picture itself is an Asset. Publish the Static Image before the product. A new or changed image may need a build. See Page revalidation.

To send a shopper to the marketplace for their country, add the country code after one dash: [Amazon-NL]https://www.amazon.nl/…. The image key stays marketplace_amazon. The country code is not part of the key. Use the ISO country codes. Upper and lower case both work.

Geo Specific Targeting

The shop always has a country: the shopper’s, or the shop default if that is unknown. For each marketplace:

  • A line for their country replaces the generic [Amazon] line.
  • Lines for other countries stay hidden.
  • If there is no line for their country, the generic line is shown.

Set this on every locale where the logos should appear.