Skip to content

Element catalogue

Reference for Kustom Element tags, locale values and attributes. Configure payment and delivery displays, include and exclude filters or express buttons.

These tags require the installation script and a registered domain. See Install Kustom Elements.

Every element requires a locale attribute, in five characters, as language-COUNTRY — the language in lower case, the country in upper case. An unsupported value falls back to English rather than failing.

For example, use en-SE, not en-se.

cs-CZ Czech · Czechiada-DK Danish · Denmarkde-CH German · Switzerlandde-DE German · Germany
en-AT English · Austriaen-AU English · Australiaen-BE English · Belgiumen-CA English · Canada
en-DE English · Germanyen-DK English · Denmarken-FI English · Finlanden-FR English · France
en-GB English · Great Britainen-NL English · Netherlandsen-NO English · Norwayen-SE English · Sweden
en-US English · United Stateses-ES Spanish · Spaines-US Spanish · United Statesfi-FI Finnish · Finland
fr-BE French · Belgiumfr-CA French · Canadafr-CH French · Switzerlandfr-FR French · France
it-IT Italian · Italynb-NO Norwegian Bokmål · Norwaynl-BE Dutch · Belgiumnl-NL Dutch · Netherlands
pl-PL Polish · Polandpt-PT Portuguese · Portugalsv-FI Swedish · Finlandsv-SE Swedish · Sweden

Both display elements accept include and exclude, each a comma-separated list of identifiers.

  • exclude hides entries the API returned for your account.
  • include adds entries the API didn’t return — useful for previewing something in Playground before it’s enabled on your account.
  • exclude is applied first. An identifier in both attributes is hidden.

Shows the Kustom payment options available for a market. The list is filtered to the methods actually configured on your account, then adjusted by include and exclude.

<kustom-payment-method-display locale="en-SE"></kustom-payment-method-display>
AttributeRequiredWhat it does
localeYesThe market whose payment methods to show
includeNoIdentifiers to add even if not returned for your account
excludeNoIdentifiers to hide
<kustom-payment-method-display
locale="en-SE"
exclude="klarna,swish"
></kustom-payment-method-display>
<kustom-payment-method-display
locale="en-SE"
include="applepay,googlepay"
></kustom-payment-method-display>

Shows the carriers customers selected in recent shipping sessions for the market.

Requires the Kustom Shipping Assistant on your Merchant ID.

Playground shows a short static list of carriers without requiring shipping sessions.

<kustom-delivery-method-display locale="en-SE"></kustom-delivery-method-display>
AttributeRequiredWhat it does
localeYesThe market whose carriers to show
includeNoCarrier identifiers to add even if not returned
excludeNoCarrier identifiers to hide
<kustom-delivery-method-display
locale="en-SE"
exclude="postnord,dhl"
></kustom-delivery-method-display>

Place the tag, then call express.initialize to supply the order. See Add express buttons for setup and order creation options.

<kustom-express-buttons id="express" locale="en-SE"></kustom-express-buttons>
AttributeRequiredWhat it does
localeYes, in practiceThe market. Left out, it defaults to a bare en with no market
reveal-modeNoprogressive (default) shows each button as it’s ready; full waits for all of them

It takes no include or exclude. Which wallets appear is set in the Portal and narrowed by market and by the customer’s browser.

This page is also available as Markdown — append .md to its URL — and is indexed in llms.txt.