BulklyCart B2B KB
Ask Question Shopify App Store
Wholesale Portal Configuration

Portal Languages & Translation Editor

Overview of Multilingual Portal Support BulklyCart enables you to localize the customer-facing wholesale portal ( /proxy/wholesale-portal ) and public regist...

#languages #translation #multilingual #rtl #locale

Overview of Multilingual Portal Support

BulklyCart enables you to localize the customer-facing wholesale portal (/proxy/wholesale-portal) and public registration page (/proxy/register) so international wholesale buyers can navigate and place orders in their native language.

Language management and custom edits are controlled entirely from your merchant dashboard. Currently, this covers all button labels, form text, table headers, and system messages. Note: It does not automatically translate Shopify product names, variant details, collection titles, or notification emails.

Accessing Languages & Content Settings

  1. Open BulklyCart in your Shopify admin.
  2. Go to Portal Pages in the left sidebar menu.
  3. Scroll down to the Languages & Content card and click Manage languages.

Configuring Portal Languages

The languages settings page is split into three main areas:

1. Default Language

Choose the default language for your wholesale portal. All buyers will see the portal in this language when they first visit. You can select any enabled language as the default. To change it, select a new language from the dropdown and confirm the change.

2. Available Languages

BulklyCart comes bundled with 11 built-in languages. By default, only English is enabled. You can toggle other languages on or off as needed:

  • English (en) - Default
  • Spanish (es)
  • French (fr)
  • German (de)
  • Portuguese (Brazil) (pt-BR)
  • Indonesian (id)
  • Italian (it)
  • Dutch (nl)
  • Chinese (Simplified) (zh-CN)
  • Japanese (ja)
  • Arabic (ar) - Right-to-Left (RTL) layout enabled

3. Custom Languages

If you need to support a language not in the built-in list, you can add a custom language:

  1. Click Add Language.
  2. Enter the Display Name, Native Name, and Locale Code (valid BCP 47 locale format like fr-CA).
  3. Select the layout direction: Left-to-Right (LTR) or Right-to-Left (RTL).
  4. Click Save.

Custom languages automatically copy all default English text labels so there are no blank strings, and you can edit them immediately. Custom languages can be deleted if no longer needed.

Using the Translation Content Editor

You can customize the exact text shown on any button, label, or system alert for any language. To open the editor, click Edit Content next to any enabled language in the language list.

Need image, with brief {Grouped translation content editor interface with search bar, translation keys grouped by portal area, and text inputs for overrides}

Key Translation Editor Features:

  • Grouped Sections: Translation keys are logically grouped by portal area (e.g., Common Layout, Cart, Login, Registration, Catalog, Checkout, and Orders) for easy navigation.
  • Search Filtering: Search for specific labels by key name, default English text, or your current translated translation.
  • Side-by-Side Reference: The default English source text is displayed next to each editable field, making translating simple.
  • Save & Unsaved Alerts: Click Save Changes to apply updates. The app will warn you if you attempt to navigate away with unsaved edits.
  • Resetting Built-in Defaults: If you make a mistake or want to revert back to BulklyCart's default translation, click Reset to Defaults to clear your overrides.

Working with Dynamic Placeholders

Some translation strings contain dynamic placeholders (e.g., :name, :count, :amount). These are placeholders that the app replaces with real data at runtime (for example, converting "Hello, :name" to "Hello, John").

[!IMPORTANT] > When editing translations, you must preserve placeholders exactly as they are written (including the colon). If you change or delete a placeholder (e.g., renaming :count to :number), the editor will display a validation error and prevent saving.

RTL (Right-to-Left) Support

BulklyCart includes native support for right-to-left layout rendering. When a buyer selects a language configured as RTL (such as Arabic), the wholesale portal layout automatically flips: sidebar menus move to the right, tables invert columns, text aligns to the right, and icons adjust accordingly. This provides a natural, native shopping experience for RTL language buyers.