- Checkout
- Features
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.
Locale
Section titled “Locale”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 · Czechia | da-DK Danish · Denmark | de-CH German · Switzerland | de-DE German · Germany |
en-AT English · Austria | en-AU English · Australia | en-BE English · Belgium | en-CA English · Canada |
en-DE English · Germany | en-DK English · Denmark | en-FI English · Finland | en-FR English · France |
en-GB English · Great Britain | en-NL English · Netherlands | en-NO English · Norway | en-SE English · Sweden |
en-US English · United States | es-ES Spanish · Spain | es-US Spanish · United States | fi-FI Finnish · Finland |
fr-BE French · Belgium | fr-CA French · Canada | fr-CH French · Switzerland | fr-FR French · France |
it-IT Italian · Italy | nb-NO Norwegian Bokmål · Norway | nl-BE Dutch · Belgium | nl-NL Dutch · Netherlands |
pl-PL Polish · Poland | pt-PT Portuguese · Portugal | sv-FI Swedish · Finland | sv-SE Swedish · Sweden |
Filtering with include and exclude
Section titled “Filtering with include and exclude”Both display elements accept include and exclude, each a comma-separated list of
identifiers.
excludehides entries the API returned for your account.includeadds entries the API didn’t return — useful for previewing something in Playground before it’s enabled on your account.excludeis applied first. An identifier in both attributes is hidden.
Payment method display
Section titled “Payment method display”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>| Attribute | Required | What it does |
|---|---|---|
locale | Yes | The market whose payment methods to show |
include | No | Identifiers to add even if not returned for your account |
exclude | No | Identifiers 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>Delivery method display
Section titled “Delivery 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>| Attribute | Required | What it does |
|---|---|---|
locale | Yes | The market whose carriers to show |
include | No | Carrier identifiers to add even if not returned |
exclude | No | Carrier identifiers to hide |
<kustom-delivery-method-display locale="en-SE" exclude="postnord,dhl"></kustom-delivery-method-display>Express buttons
Section titled “Express buttons”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>| Attribute | Required | What it does |
|---|---|---|
locale | Yes, in practice | The market. Left out, it defaults to a bare en with no market |
reveal-mode | No | progressive (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.
Related
Section titled “Related”- Install Kustom Elements — the installation this depends on
- Add express buttons — initializing express buttons and choosing who creates the order
- Integration models — where Elements fits beside the integration models
- Shipping Assistant — required for delivery method display
This page is also available as Markdown — append .md to its URL — and is indexed in llms.txt.