Zonos Hello for Magento 2

Want to give your international customers the same kind of shopping experience as your domestic customers?

Let us introduce you to Zonos Hello!

When an international shopper arrives at your site, Zonos Hello welcomes the shopper and messages them in their local language, letting them know we’re here for you. As they look around your site and select a product, the Zonos Hello widget personalizes the experience in their language and currency with important details they need to know, e.g. duties and taxes displayed in their currency.

It’s quick and easy to integrate our extension and start delivering a better experience for your international shoppers.

Oh, and in case you were wondering if this would burn a hole in your wallet - Zonos Hello is FREE!


Click here to learn about our Hello Premium features, such as:


For Magento 2.0, 2.1 and 2.2, you will need PHP 7.0.6 or greater or PHP 7.1.x (whichever is compatible with your version of Magento).

For Magento 2.3, you will need PHP 7.1.x.

You can find our Zonos Hello app for Magento 2 on the Magento marketplace.

There are three options to install the Zonos Hello module.

Option 1 - Web setup wizard (preferred method)

To install the app, follow the instructions from the Magento User Guide.

Option 2 - Install via Composer

Important - Installation with this method must be performed by an experienced Magento developer.

This option will install Zonos Hello as a dependency.

To install the app, (from your terminal) go to your <root magento dir>, then follow the steps below:

To uninstall the app:

Option 3 - Download the extension

Important - You will not be able to run: php bin/magento module:uninstall Zonos_Hello, because it was not installed through Composer.

To install the Zonos Hello module:

  1. Go to the Magento marketplace.
  2. Search for “Zonos Hello”.
  3. Download the Zonos Hello app for Magento 2 extension.
  4. Extract the extension into the <root magento dir>/app/code/Zonos folder (create any folder that does not exist).
  5. From the command line, change the directory to your root Magento 2 directory.
  6. Run the following commands:
    • php bin/magento module:enable Zonos_Hello
    • php bin/magento setup:upgrade
    • php bin/magento setup:di:compile

To uninstall the Zonos Hello module:


  1. Obtain your Site Key at https://app.zonos.com/#/hello.
  2. Go to your Magento Admin > Stores > Configuration > Zonos > Zonos Hello. 3 Configure the following options as instructed below:
    • Enable - This allows the Zonos Hello widget to display duty and tax quotes while customers visit your product pages.
    • Site Key - Enter your Zonos-provided site key obtained from Step 1.
    • Currency Conversion Selectors - If you want Zonos Hello to convert currency, paste your CSS selectors here. Multiple selectors are separated with a comma, e.g. .price,.__current-price,.__subtotal,.__original-price.
    • Hide Domestic Elements (OPTIONAL) - If you need or want to hide domestic elements for your international customers, input CSS selectors for elements you want to hide e.g. .nav-6,.action-add.