Skip to main content

Documentation Portal

Site Customization

The Site Customization feature lets you set the look and feel and behavior of the following site usage stages:

Desktop vs Mobile Dimensions

Overview

Global-e Site Customization screens may render differently on Desktop and Mobile devices. This section describes the Desktop versus Mobile differences for each of the four customizable screen types (Welcome Pop-Up, Country Switcher, Marketing Banner, and Checkout) including recommended dimensions, customization scope, and any mobile-specific behavior.

All four screen types support 27 languages. Edits made to one language do not update the others. For consistency, apply translated changes manually across all language versions.

Deliver your mock-up in one of the following formats:

  • PSD

  • XD

  • Online design (e.g., Zeplin)

  • Image (PNG or JPEG recommended; other formats supported)

  • PDF

Tier Availability

The Desktop versus Mobile distinction applies across all merchant tiers (Enterprise, Pro, and NCE). However, which screen types a merchant can edit depends on their tier:

Screen Type

Enterprise

Pro

NCE

Welcome Pop-Up

Country Switcher

Marketing Banner

Checkout

NCE merchants are restricted to the Marketing Banner screen only. For Pro and Enterprise merchants, all four screen types are available, and the Desktop versus Mobile distinction described in this section fully applies.

Shipping Banner
Rendering Across Devices

The Shipping Banner renders identically on Desktop and Mobile. There is no separate Desktop or Mobile variant-the banner uses a fluid container that spans the full width of its parent element on every device. The same configuration (background color, height, font, and text color) applies to all viewports.

Customization Scope

The following tables shows the customization scope:

Element

What is Customizable

Background color

Color of the banner background

Banner height

Specified in pixels by the merchant

Font

Font family for the banner text

Text color

Color of the banner text

All four customization options apply equally to Desktop and Mobile.

Styling Precedence Note
Styling Precedence Note

If the container hosting the banner on the merchant's site includes its own CSS properties, the styling configured via the Site Customization editor may not take effect. In such cases, the merchant must adjust their container CSS to allow the banner styling to apply.

The following tables shows the recommended dimensions:

Aspect

Value

Width

100% of the container (fluid; not configurable)

Height

Configurable in pixels by the merchant; no recommended fixed value

Accessing the Customisation Page

To customize your page configurations, you must access the Customization page.

To access the Customization page
  1. Navigate to Configuration > Customization from the top menu:

    Configuration_Customization_Menu.png
  2. Select a merchant from the Merchant menu.

    The following page is displayed.

    Site_Customization_Main_Page_Callouts__Enterprise_-_No_Checkout_.png
  3. Configure the elements above according to the table below:

    No.

    Element

    Description

    1

    Welcome Popup tab

    View, modify, and manage elements related to your Welcome popup screen.

    2

    Switcher Popup tab

    View, modify, and manage elements related to your Switcher Popup screen.

    3

    Free Shipping Banner tab

    View and modify your shipping banner page configuration.

Configuring Your Shipping Banner Page

From here you can view and modify your shipping banner page configuration. A live preview of your configurations is displayed on the right side of the page.

Note that you can reset your settings to their default configurations by clicking Reset to default at the bottom of the page.

Free_Shipping_Banner_2.png
Configure your Free Shipping Banner page
  1. Follow steps 1 and 2 in Accessing the Customisation Page.

  2. Click Free Shipping Banner.

  3. Click Show banner on website.

  4. Modify the Design settings section as needed.

  5. Modify your list of countries (optional):

    1. Click list of countries.

    2. Select all of the relevant countries.

    3. Click OK.

  6. Select a language from the language menu on the far right of the page.

  7. Enter the text of your shipping banner message in the text field.

    Note

    The text in the curly brackets pulls information from the database.

  8. Create an additional group of countries (optional):

    1. Click Create additional group of countries.

    2. Select a continent from the map.

    3. Select your countries from the Create a new group of countries panel.

    4. Click OK.

  9. Click Save.