You can configure multiple locales to enter and display content in any language. Only locales enabled by you will be visible to customers in a storefront. On the frontend, a storefront may use Swell.js to retrieve and display localized content.


Enabling multi-language

Navigate to Settings > General and find the link to Enable multi-language under the heading Locale and timezone. Clicking this link will enable settings for your default locale and reveal a new action labeled Add locale.

In the Add locale window, you may customize the label used in a storefront to represent the locale selection. Once multiple locales are configured, it's possible to change your default locale using the Set as default action from the Edit window.

Note: Changing your default locale will not affect any existing content, but it will immediately affect the content displayed in a storefront when no specific locale is selected.

Toggle Require content for this locale in order to force the dashboard interface to require a value when saving changes, if the field is normally required. Choose any Fallback locale to cause storefront content to default to this value if a content field is left empty.

Disabling a locale will hide it from the storefront, while it will continue to be available in the dashboard for content editing.

To disable multi-language, remove each of the configured locales one by one.

Content editing

In the Swell dashboard, users can select locales to edit content in-place by clicking the locale icon in the top portion of a page or modal window. Extra input fields will be present for each selected locale. This way, any standard or custom text field can be localized, including email notification fields.

Localizing email notifications

Under the Fields tab of the notification edit window, users have the ability to customize and localize text used in a notification template. Toggle Edit fields to add, remove, or re-order existing notification fields.

Preview notification content and send test emails in any configured locale.

Localizing storefront and checkout

A storefront app can configure settings and content types with a localized property to enable the localization of text fields in the Swell storefront editor.

Swell Checkout has its own language fields that can be edited by navigating to Design & global settings > Checkout > Language.

Localizing content with the Swell API

Developers can manage localized content for custom interfaces using the Swell API. For more details, read the API reference.

Did this answer your question?