> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Sample Flow

## Article: Sample Flows

## Article Link: https://dev.wix.com/docs/api-reference/business-management/multilingual/translation/sample-flow.md

## Article Content:

# Sample Use Case and Flow

This article presents a possible use case and corresponding sample flow that your app can support. It provides a useful starting point as you plan your app's implementation.

## Translation flow with default app content and user-generated translations

Suppose you're developing an app for managing book collections, and you want your Wix users (bookstore owners) to be able to translate the book collection data from the primary language `en-us` into other languages on their site.

### Step 1 | Define the schemas

Use the [Create Schema](https://dev.wix.com/docs/rest/business-management/multilingual/translation/translation-schema/create-schema.md) method to define which fields of your book and collection entities are translatable. This step only needs to be done once. The `fields` parameter maps each field name (as a string) to an object specifying the data type (like text or image) and any constraints (like minimum or maximum length). The string acts as a key, which you'll use when adding translation content. The Create Schema method returns a schema ID  that is also required for adding the translation content in the following step.

In our example, we define two schemas with the following fields:

| **Schema**      | **Fields**                                                       |
|---------------- |------------------------------------------------------------------|
| Book            | <ul><li>`Title`</li><li>`Author`</li><li>`Description`</li></ul> |
| Book Collection | <ul><li>`Title`</li></ul>                                        |

### Step 2 | Add default translatable content

Ask the Wix user to specify the site's primary language. Call the [Create Content](https://dev.wix.com/docs/rest/business-management/multilingual/translation/translation-content/create-content.md) method with the schema ID and the string key for each field to add your app's default content in the site's primary language. This content will serve as the base for all future translations across different locales.

For example, if the site's primary language is `en-us`, your default translatable content (field values) for a book may look like this:

```json
  "fields": {
    "Title": {
      "textValue": "Pride and Prejudice",
      "updatedBy": "USER",
      "published": false,
    },
    "Author": {
      "textValue": "Jane Austen",
      "updatedBy": "USER",
      "published": false,
    },
    "Description": {
      "richContent": {
        "nodes": [
          {
            "type": "PARAGRAPH",
            "id": "qk4dj27",
            "nodes": [
              {
                "type": "TEXT",
                "textData": {
                  "text": "Pride and Prejudice follows the character development of Elizabeth Bennet, the protagonist of the book, who learns about the repercussions of hasty judgments and comes to appreciate the difference between superficial goodness and actual goodness.",
                }
              }
            ]
          }
        ],
        "metadata": {
          "version": 1,
          "id": "ae5c8167-31a2-4bdd-8f29-f376d1a36d22"
        }
      },
      "updatedBy": "USER",
      "published": false,
    }
  }
```

### Step 3 | Wix user adds translations

The Wix user translates the book and book collection content via the [Translation Manager](https://support.wix.com/en/article/wix-multilingual-using-the-translation-manager). When they save the translations, the Translation Manager automatically calls the [Translation Content API](https://dev.wix.com/docs/rest/business-management/multilingual/translation/translation-content/introduction.md) to store the updated content and mark it as ready to publish.

### Step 4 | Use published translations

When a site visitor views the site in a language other than the site’s primary language, call [Query Published Content](https://dev.wix.com/docs/rest/business-management/multilingual/translation/translation-published-content/query-published-content.md) to retrieve and display the publish-ready translated content in their language. This ensures site visitors see the appropriate translations for their locale.