Platform DocsPlayers DocsRelease Notes
System StatusSubmit a CaseDashboard LoginCompany Site

Translate content metadata

Add and manage translations for your content title, description, and other fields

Suggest Edits

In addition to captions and subtitles, JWP enables you to translate your content metadata into any language when using content types. Content metadata is visualized in your app to provide the viewer with more information about a media item.

Translated description of video in the JW Web App

Translated description of video in the JW Web App

Translating metadata offers you a host of benefits:

  • Expanding to a global market of viewer groups
  • Improving user experience in the native languages of viewers
  • Increasing revenue opportunities through language support

Prerequisites

Item Description
App config entitlement Entitlement to use the app config

App config entitlement also reveals the Translations tab on the media details page.

For more information, contact your JWP representative.
Content type associated with media item Type of media based upon shared custom parameters

For more information, learn how to add a content type.
Updated content type schema Content type schema with translations enabled

Enabling translation requires two components:
  1. Adding a language
  2. Marking translatable fields

(1) Adding a language:
To add a language, you must create a content type schema with a languages object nested under the metadata. You can add up to 15 languages per schema.

See the following example: 
{
  "metadata": {
    ...,
    "languages": [
      {
        "code": "en",
        "name": "English"
      },
      {
        "code": "de",
        "name": "Deutsch"
      }
    ]
  }
}

NOTE: You may use any two- or three-letter code to denote a language. You may also include a two-letter or three-number regional marker after a hyphen (en-US).

(2) Marking translatable fields:
Upon adding a language, you must include a translatable property to mark all fields that you would like to translate.

See the following example: 
{
  "param": "composer",
  "label": "Composer",
  "required": true,
  "details": {
    "field_type": "input",
    "placeholder": "Enter composer",
    "translatable": true
  }
}

NOTE: You can only translate fields that accept a text input (a field_type of input or textarea). Auto-populated values or preset values selected from a menu cannot be translated.

Add a translation

📘

The app provider is responsible for displaying specific translations to the viewer and setting the default language. You may set any language as the default for your app.

Follow these steps to translate your content metadata:

  1. From your Media Library, select a media item. The media details page appears.

  2. Click the Translations tab. Your loaded Languages appear.

    🚧

    If you have not added any languages to your content types schema, a callout appears noting that No languages are available.

    Translations tab with loaded languages

    Translations tab with loaded languages

  3. Select a language. The Translation panel opens and displays your translatable fields.

    📘

    By default, the Title and Description fields will appear in the panel.

    To add any additional fields, you must set the translatable property of the content type schema field to true.

    All translatable fields that are not part of the default language will appear with a language code postfix (defined when adding the language).

  4. Enter a translation into each text field.

  5. Click Apply. The Translation panel closes.

    📘

    The Status column of the Languages section will alert you whether a translation is Completed or still has Empty fields.

  6. Click Save.


Edit a translation

You can edit an existing translation at any time. Follow these steps to update a translation:

  1. From your Media Library, select a media item. The media details page appears.
  2. Under the Translations tab, your translated Languages appear.
  3. Select a language. The Translation panel opens and displays your translatable fields.
  4. Enter a new translation into your desired text field.
  5. Click Apply. The Translation panel closes.

    📘

    The Status column of the Languages section will alert you whether a translation is Completed or still has Empty fields.

  6. Click Save.

Delete a translation

Your translation definitions are associated with your content type schema. The deletion of a content type from a property or media item does not affect translation metadata. The translation definitions will be stored as custom parameters. Deleting a content type only affects the visualization of metadata in apps and the validation of metadata in the JWP dashboard.

🚧

Changing the content type schema may alter the appearance of the Translations tab for a media item. Deleting a language from the content type schema will remove the language from the Translations tab.

Follow these steps to delete a translation:

  1. From your Media Library, select a media item. The media details page appears.
  2. Under the Translations tab, your translated Languages appear.
  3. Select a language. The Translation panel opens and displays your translatable fields.
  4. Delete the text from your desired translatable field.
  5. Click Apply. The Translation panel closes.

    📘

    The Status column of the Languages section will alert you whether a translation is Completed or still has Empty fields.

  6. Click Save.

Updated 7 days ago