> For the complete documentation index, see [llms.txt](https://docs-shpf.bsscommerce.com/bss-b2b-quick-order-and-quotes/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-shpf.bsscommerce.com/bss-b2b-quick-order-and-quotes/request-for-quote/storefront-translation.md).

# Storefront Translation

Learn how to configure multi-language translations and automatic locale switching for your Request for Quote storefront experience.

Customize all customer-facing text, button labels, modal form fields, and notification banners for **Request for Quote (RFQ)** across multiple storefront languages.

With the **Auto-Switch Quote Text by Customer Locale** engine, your quote submission flow automatically adapts to the buyer's language based on their active market context in Shopify, ensuring a seamless localized experience without language friction.

***

## 1. Overview & Key Benefits

When selling across international markets (such as bilingual regions or pan-European B2B commerce), having storefront navigation in the buyer's native language while the quote submission form abruptly displays in English introduces friction and lowers conversion rates.

The **RFQ Storefront Translation** settings provide:

* **Per-Locale Translation Management**: Define custom translations independently for each language activated in your store's **Shopify Markets**.
* **Automatic Locale Detection**: The storefront component detects the visitor's current language preference and automatically displays the matching localized text.
* **Intelligent Language Fallback**: If a specific translation field or an entire locale is left blank, the system automatically falls back to your store's default primary language without breaking layouts or displaying empty labels.
* **Instant Live Preview**: Test and review button labels, modal forms, eligibility notices, and toasts directly in your admin preview before saving.

```mermaid
graph TD
    A["Customer Visits Storefront in Specific Locale (e.g., German /de)"] --> B{"Is Quote Translation Configured for 'de'?"}
    B -- Yes --> C["Display Full German Translation on Quote Button, Form & Toasts"]
    B -- No / Partial --> D["Fallback to Store Primary Default Language (e.g., English /en)"]
    C --> E["Localized Quote Submission Flow"]
    D --> E
```

***

## 2. Where to Configure RFQ Translations

To access the RFQ translation management console:

1. In Shopify Admin, open **BSS B2B Quotes**.
2. In the navigation menu, select **Translations** > **Request For Quote**.
3. At the top of the editor, use the **Locale Selector** dropdown to select the target language you wish to customize.

> \[!NOTE] **Plan Requirement**: Multi-language storefront translation for Request for Quote is available on the **Growth** plan and above.

***

## 3. The 5 Translation Tabs

The translation editor organizes all user-facing copy into 5 functional categories:

### 3.1 Quote Button Tab

Controls the text displayed on quote trigger buttons across your storefront:

| Field                    | Description                                                                                     | Default Text (English) |
| ------------------------ | ----------------------------------------------------------------------------------------------- | ---------------------- |
| **Quote Button Content** | Text displayed inside the main quote button on Product Detail Pages (PDP) and Collection pages. | `Add to Quote`         |
| **Total Quantity Label** | Summary label shown when multiple variants are selected in bulk.                                | `Total Quantity:`      |

### 3.2 Toast Notifications Tab

Controls instant feedback alerts triggered when buyers interact with quote buttons:

| Section / Alert              | Description                                                                         | Default Text (English)                                                                                                                                                                         |
| ---------------------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Add Items Success**        | Popover alert confirming products were successfully added to the quote list.        | <p><em>Heading:</em> <code>Added to quote!</code><br><em>Message:</em> <code>Your selected items have been added to your quote request.</code><br><em>Button:</em> <code>View Quote</code></p> |
| **Add Items Failed**         | Alert shown if an item cannot be added (e.g. inventory constraint).                 | <p><em>Heading:</em> <code>Failed to add items</code><br><em>Message:</em> <code>Unable to add items to quote. Please try again.</code></p>                                                    |
| **Approve / Reject Success** | Confirmation displayed when a buyer approves or declines a quote via proposal link. | <p><em>Heading:</em> <code>Quote Accepted</code> / <code>Quote Declined</code><br><em>Message:</em> Status confirmation message.</p>                                                           |
| **Link / Session Errors**    | Alert when a proposal link has expired or has already been converted.               | <p><em>Heading:</em> <code>Invalid Link</code><br><em>Message:</em> <code>This proposal link is no longer active.</code></p>                                                                   |

### 3.3 Eligibility Notifications Tab

Controls guidance banners shown when certain products in the cart or on the page do not qualify for quoting based on your active Quote Logic rules:

| Section                   | Description                                                                                  | Default Text (English)                                        |
| ------------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| **Notice Title**          | Main banner title for eligibility warnings.                                                  | `Quote Eligibility Notice`                                    |
| **All Items Invalid**     | Message shown when none of the selected products qualify for quote submission.               | `None of the selected items are eligible for quote requests.` |
| **Partial Invalid Items** | Guidance message when only some items qualify, prompting the buyer to choose how to proceed. | `Some items in your selection cannot be quoted.`              |
| **Action CTAs**           | Action buttons for the eligibility modal.                                                    | `Return to Cart` / `Continue with Eligible Items`             |

### 3.4 Quote Form Tab

Controls labels, headings, and input placeholders inside the main quote request submission popup modal:

| Field                       | Description                                                            | Default Text (English)                                                                                                                             |
| --------------------------- | ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Modal Header Title**      | Title displayed at the top of the quote popup window.                  | `Request a Quote`                                                                                                                                  |
| **Product Section Heading** | Subtitle above the itemized product list table.                        | `Selected Products`                                                                                                                                |
| **Form Section Heading**    | Subtitle above custom form fields (Name, Email, Note, PO Number, VAT). | `Contact & Shipping Information`                                                                                                                   |
| **Submit Button**           | Main call-to-action button submitting the quote request to admin.      | `Submit Quote Request`                                                                                                                             |
| **Cancel Button**           | Dismissal button closing the quote modal.                              | `Cancel`                                                                                                                                           |
| **Empty State**             | Message displayed if the modal opens with zero selected items.         | <p><em>Heading:</em> <code>Your quote is empty</code><br><em>Message:</em> <code>Please browse our catalog and add items to your quote.</code></p> |

### 3.5 Quote History Tab

Controls storefront labels inside the buyer's customer account dashboard (`/pages/quote-history` or new customer accounts):

* **Page Headers & Tab Labels**: Titles for *All Quotes*, *Under Review*, *Approved*, *Rejected*, and *Expired*.
* **Table Columns**: Labels for *Quote ID, Date, Items, Status, Total, Actions*.
* **Status Badges**: Visual status indicators (`Open`, `Under Review`, `Approved`, `Rejected`, `Expired`).
* **Action CTAs**: Buttons for *View Details*, *Download PDF*, *Proceed to Checkout*, and *Create Similar Quote*.

***

## 4. Step-by-Step: Adding a New Language Translation

Follow these 4 steps to configure a localized quote flow for an additional market:

### Step 1: Select Your Target Locale

1. Navigate to **Translations** > **Request For Quote**.
2. Click the **Locale** selector at the top-left of the page.
3. Choose the locale you wish to translate (e.g. `de` for German or `fr` for French).
   * *Note: Only locales currently published in your Shopify Markets settings will appear in this list.*

### Step 2: Enter Localized Text

1. Click through the 5 translation tabs (**Quote Button**, **Toast Notification**, **Eligibility**, **Quote Form**, **Quote History**).
2. Enter your localized copy into the respective text fields.
3. You do not need to fill out every field at once—any empty fields will automatically inherit your store's primary language.

### Step 3: Inspect Real-Time Previews

* As you type into any text field, inspect the **Interactive Live Preview** on the right side of the screen.
* Check button widths, text wrapping, and notification formatting to ensure your copy fits your storefront theme cleanly.

### Step 4: Save & Publish

1. Click **Save** in the top-right corner.
2. Visit your live storefront, switch your currency/country picker to the localized market, and verify that the quote button, modal form, and notifications render in the target language.

***

## 5. Real-World Scenario: Multi-Market European Store

**Store Context**: A wholesale distributor based in the Netherlands sells across the DACH region and France:

* **Primary Language**: English (`en`)
* **Target Markets**: Germany (`de`) and France (`fr`)

**Configuration**:

1. In **Translations > Request For Quote**, the merchant selects `de` and translates key CTAs:
   * `Quote Button Content`: `Angebot anfordern`
   * `Modal Header Title`: `Unverbindliches Angebot anfragen`
   * `Submit Button`: `Anfrage absenden`
2. Next, the merchant selects `fr` and configures French copy:
   * `Quote Button Content`: `Demander un devis`
   * `Modal Header Title`: `Demande de devis professionnel`
   * `Submit Button`: `Envoyer la demande`
3. A buyer from Italy visits the store (`it`). Because Italian copy has not yet been translated, the system seamlessly displays the default English (`Add to Quote`), preventing broken strings or missing buttons.

***

## 6. Related Guides

* [Customize Quote Form](/bss-b2b-quick-order-and-quotes/request-for-quote/quote-logic/customize-quote-form.md)
* [Set Up Prices & Buttons](/bss-b2b-quick-order-and-quotes/request-for-quote/quote-logic/set-up-prices-and-buttons.md)
* [Reorder Storefront Translation](/bss-b2b-quick-order-and-quotes/reorder/storefront-translation.md)
* [Quote Automation & Reminders](/bss-b2b-quick-order-and-quotes/request-for-quote/advanced-settings.md)