DOCS

Customize display countries

Customize display countries

Control how Hello displays for certain countries.

By default, Hello will only display for countries that are in a shipping zone in your Zonos settings. You can control which buyer countries see Hello and which countries appear in the Hello country selector from Dashboard.

Configure country display rules in Dashboard 

Navigate to Dashboard -> Settings -> Hello and find the Country display rules section.

Widget visibility

Control which buyer countries see the Hello widget. Choose one of the base rules, then use the Always show and Never show lists to override specific countries.

  • All countries - Every country that Hello supports.
  • Only shippable countries - Countries you ship to from your shipping settings.
  • Always show - Countries that always appear, even if the base rule excludes them.
  • Never show - Countries that never appear, even if the base rule includes them.

Hello widget visibility settings in
Dashboard

Country selector

Control which countries appear in the Hello country selector dropdown, using the same base rules plus Always show and Never show overrides.

Hello country selector settings in Dashboard

Deprecated JS options

The showForCountries and showCountryList properties on helloSettings are deprecated. Configure country display rules in Dashboard instead — values set there will be loaded automatically by the Zonos JS script.

Listen for country changes 

You can listen for changes to the selected country in Hello by passing a callback function to the onCountryChange property in the helloSettings object in Zonos.init. This will trigger whenever the user selects a new country from the Hello country selector.

1window.Zonos.init({
2 onCountryChange: ({ countryCode, currencyCode }) => {
3 console.log("Selected country and currency:", countryCode, currencyCode);
4 },
5});
Book a demo

Was this page helpful?