# Introduction to B2TRANSLATE

Welcome to **B2TRANSLATE**, a comprehensive web-based localization tool integrated with B2BROKER products. This tool enables you to efficiently translate your product's web user interfaces (WebUIs) into multiple languages, ensuring global accessibility for your applications.

B2TRANSLATE organizes translations using a clear hierarchy that makes managing complex localization projects intuitive:

1. **Project types**: Your B2BROKER products.
2. **Projects**: Individual WebUIs within each product, such as test and production websites.
3. **Keys and translations**: Specific UI elements and their localized texts.

Let's explore each component in detail.

## Project types

**Project types** correspond directly to your purchased B2BROKER products.

They're automatically added to your B2TRANSLATE. If you have multiple products, all of them can be accessed on a single page for your convenience.

Each product may have one or more WebUIs, for example if you have several instances. In this case, the project type encompasses different **projects** that represent these WebUIs.

{% hint style="info" %}
If you need any adjustments in the project types, contact your account manager.
{% endhint %}

## Projects

**Projects** are separate WebUIs of your products.

Each project type includes a **DEMO** project, featuring a full set of categories, languages, and translations. The keys in this project aren't associated with any specific WebUI and serve only for demonstration. While you can't modify translations within the DEMO project, you can copy them to your other projects.

Besides DEMO, each project type includes one or more "real" projects. These projects are linked to the WebUIs of your product and are under your full control. You can set and edit translations for the keys within such projects.

{% hint style="info" %}
If you need any adjustments in the projects, contact your account manager.
{% endhint %}

## Keys and translations

**Keys** are identifiers that reference specific UI elements. **Translations** are text strings in various languages that are assigned to these keys. For example, the key `MyProject.CreateNewDeposit` can be assigned the English translation "Deposit funds", which will appear as the caption for the related UI element in the WebUI.

The key list is product-specific and and may be updated with product releases. B2TRANSLATE provides you with flexible filters to detect new and empty keys, ensuring your WebUIs remain up-to-date. Refer to [Filter keys](/user-guide/filter-keys.md) to learn more.

### Default and custom translations

Each key has the following translation fields:

* **Source** (read-only): A pre-defined translation to English, provided by B2TRANSLATE. This field can't be edited.
* **B2TRANSLATE** (read-only): A pre-defined translation to a selected language (if distinct from English), provided by B2TRANSLATE. This field can't be edited.
* **Custom translation** (user-editable): A user-provided custom translation to a selected language. This value is initially empty and can be edited anytime. Refer to [Add or modify translations](/user-guide/manage-translations/add-or-modify-translations.md) to learn more about customizing translations.

### Display logic in WebUI

B2TRANSLATE follows an intelligent fallback system for displaying translations:

1. Custom translation (if exists)

   ↓ (if empty)
2. Default translation in a selected language (if exists)

   ↓ (if empty)
3. Source English translation

   ↓ (if explicitly set to empty)
4. No translation (blank)

<details>

<summary>Examples</summary>

* **Key**: `MyProject.Button.BuyNow`
* **Language**: Spanish
* **Source English translation**: Buy Now
* **Default Spanish translation**: Comprar Ahora
* **Custom Spanish translation**: ¡Comprar Ya!

→ **Display result**: ¡Comprar Ya! (Custom Spanish translation)

***

* **Key**: `MyProject.Button.BuyNow`
* **Language**: Spanish
* **Source English translation**: Buy Now
* **Default Spanish translation**: Comprar Ahora
* **Custom Spanish translation**: –

→ **Display result**: Comprar Ahora (Default Spanish translation)

***

* **Key**: `MyProject.Button.BuyNow`
* **Language**: Spanish
* **Source English translation**: Buy Now
* **Default Spanish translation**: –
* **Custom Spanish translation**: ¡Comprar Ya!

→ **Display result**: ¡Comprar Ya! (Custom Spanish translation)

***

* **Key**: `MyProject.Button.BuyNow`
* **Language**: Spanish
* **Source English translation**: Buy Now
* **Default Spanish translation**: –
* **Custom Spanish translation**: –

→ **Display result**: Buy Now (Source English translation)

</details>

### Categories

**Categories** represent separate functional modules of products and are used to group keys. You can filter keys by a specific category.

Each project includes the **default** category that contains the keys used throughout the product, such as error messages or names of UI elements. These keys are translated into English and any other languages selected during purchase.

The set of categories depends on the product and can't be edited.

## Main features

B2TRANSLATE offers you a comprehensive toolkit for efficient translation management.

### Progress tracking and quality control

* **Completion monitoring**: Track translation progress by language or project.
* **Smart filtering**: Identify new keys and missing translations instantly.
* **Quality assurance**: Ensure complete coverage across all WebUI elements.

### Efficiency and automation tools

* **Translation reuse**: Copy translations between projects to reduce redundant work.
* **AI-powered translations**: Integrate with ChatGPT for automated translation assistance (contact your account manager for access).
* **Bulk operations**: Export/import via CSV for large-scale editing workflows.

### Advanced localization features

* **Plural form handling**: Support complex grammatical rules for accurate translations.
* **Real-time updates**: Changes reflect immediately in connected WebUIs.
* **Collaborative workflows**: Team-friendly interface for multi-user translation projects.

### Support and feedback

* **Integrated feedback system**: Submit suggestions and report issues directly within the platform.
* **Dedicated support**: Contact your account managers for technical assistance.

{% hint style="success" %}
Ready to start translating? Explore the **User guide** to master B2TRANSLATE's translation management capabilities.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.b2translate.b2broker.com/get-started/introduction-to-b2translate.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.