Localize Store Presence

Localize storefront content to best reach global Epic Games Store users

11 mins to read

Overview

Through the Epic Games Store publishing tools, you can localize your store presence to provide a better experience for global Epic Games Store users. Localizing the content of your storefront allows users to review and interact with your product in their preferred language.

To help you localize your store presence, the following tools and services are available:

  • Text localization: Manage localized strings for text entities associated with your product via a bulk upload template available in the Dev Portal.
  • Epic Translation Service: A complimentary localization service available for all products on the Epic Games Store. If you are unable to provide your own translations, you can request support from the Epic Games Store team.
  • Asset Localization (Image and Video): Upload localized images and videos to ensure storefront users are presented with the right assets for their region.

Supported Languages

The Epic Games Store currently supports the following languages:

Language Locale code
Englishen
Arabicar
Frenchfr
Germande
Italianit
Japaneseja
Koreanko
Polishpl
Portuguese (Brazil)pt-BZ
Russianru
Spanish (Spain)es-ES
Spanishes
Thaith
Turkishtr
Chinese (Simplified)zh-CN
Chinese (Traditional)zh-Hant

Text Localization

In the Dev Portal, you can manage localized content for your store presence by visiting Your Product > Epic Games Store > Localization.

The Localization section provides a downloadable template that is used to collect localized content for your various entities, such as store settings, offers and pages. If you are unable to provide your own translations, the Epic Games Store offers a complimentary translation service to partners.

To get started, review the following sections:

Create Text Localizations

Before you begin, ensure the necessary fields for the entities you wish to translate have been completed in English. English content is required for all products distributed on the Epic Games Store, and this content is used to populate the localization template.

Character limits for individual text fields are applied consistently across all languages. To ensure localized content strings can be imported without issue, we recommend keeping English (en) text to no more than 70–80% of the maximum character limit.

Once your entities are ready, follow the process below to localize your content:

  1. Download the localization template
  2. Complete the localization template
  3. Import Localizations
  4. Preview your localizations
  5. Publish your localizations

Step 1: Download the Localization Template

To start the process, you must first download the localization template. The localization template is a .CSV file containing all user-facing content strings for your selected entities.

Once retrieved, you will add your translations to this template as needed. If you cannot provide your own translations, review the Request Text Translations from the Epic Translation Service section for more information.

To retrieve the localization template, complete the following:

  1. In the Dev Portal, navigate to Your Product > Epic Games Store > Localization.
  2. Ensure the Dev sandbox is selected. Then, click Download Template.
  3. Select one or more entities to localize. Then, click Download to export the template.

Once downloaded, continue to Step 2: Complete the Localization Template to populate the .CSV file with your translations. If you have already created one or more localizations, the file may already contain data in certain locale columns.

If you have some entities that support complete localization (i.e., content provided for all locales) and other entities that do not fully support localization (i.e., content provided for only some locales), it is recommended that you download and complete these templates separately. For example, if your Product Home is to be fully localized, but Product Configuration is not, manage these templates separately as follows:


  1. Download the Product Home template and provide localizations for all locale columns. Upload Product Home Page template.
  2. Download the Product Configuration template and provide localizations in one or more locale columns as needed. Remove any columns that do not contain localizations. Upload the Product Configuration template.

Step 2: Complete the Localization Template

Next, fill out the localization template with your translated content.

In the .CSV file, each row represents a specific string, with the en column containing your English content. Additional locale columns are provided to collect your translated strings for each supported language.

Locale columns are labeled by locale code (e.g., ja or ko). For a full list of codes, review the Supported Languages section.

To ensure a successful import of your localization template, do not change the template structure of the .CSV file. Do not edit or remove the first row (header) of the template or adjust the file format. Changes to the template structure or file format may cause an import to fail.

To complete the localization template, follow the steps below:

  1. In the .CSV file, review the Localization Field, Field Description, and en columns to identify the strings requiring translation.
  2. For each string, add your translated content to each locale column as needed.
  3. Remove any locale columns that are not being used. Your completed file should only include locale columns that contain translated content.
  4. Save your completed template as a .CSV UTF8 file.

Step 3: Import Localizations

Once your template is finalized, follow the steps below to upload the file and import your localizations:

  1. In the Dev Portal, navigate to Your Product > Epic Games Store > Localization.
  2. Click Upload File. Then, upload your completed .CSV file. The max file size is 5MB.
    • If the import was successful: The file displays with a confirmation message, and you can continue to Step 4: Preview Localizations.
    • If the import presented errors: If any issues are detected in the file, an alert message displays on screen. These errors must be resolved before you can continue.

Errors during the import process may occur for a variety of reasons. Common errors include translated content for a specific field exceeding its character limit or translated content missing for one or more required fields.

Languages affected by one or more errors display with a warning icon in the Languages section of the screen.

  • Click an affected language to review its specific error details. Using this information, resolve any issues in your .CSV file. Then, upload the modified file using the steps above.
  • Repeat this process as needed to resolve any additional errors. Once you have successfully imported your localizations without error, continue to Step 4: Preview Localizations.

Step 4: Preview Localizations

Next, preview how your localizations display to users. Note that this process is only available for offer and page entities.

  1. Navigate to Your Product > Epic Games Store > Localization.
  2. In the Dev sandbox list, click the entity you wish to preview.
  3. Select a language from the list to the right. Then, click Text.
  4. Fields containing localized content then display. Click Preview in Store to the top right to launch a storefront preview in a new tab.
  5. Review the preview to ensure your localized content displays as desired. When ready, continue to Step 5: Publish Localizations

Step 5: Publish Localizations

To publish your localizations, you first must push the localized entities to the Stage sandbox and submit them for review. Once approved, you can then publish your changes to the Live sandbox.

  1. Navigate to Your Product > Epic Games Store > Release Management.
  2. In the Dev sandbox, click Push to Stage.
  3. Select the entities containing new localizations from the list.
  4. Click Push to Stage. The entities then display in the Stage sandbox section of the screen.
  5. In the Stage sandbox, click Submit for Review to submit your content to the Epic Games Store team.
  6. Once your entities have been approved, push your content to the Live sandbox by clicking Push to Live in the Stage sandbox.

After you have created one or more localizations, you can manage this information through the Dev Portal. For more information, review the Localization Management.

During the review process, the Epic Games Store team may provide feedback that requires content changes in English. In this scenario, you must also update any associated translations before resubmitting your entities for review.

Request Text Translations from the Epic Translation Service

While not required, localizing your store presence is highly recommended to help your product reach a wider audience of Epic Games Store users.

To support your localization efforts, the Epic Games Store offers the Epic Translation Service. If you are unable to provide your own localizations, you can request complimentary text translations from this service.

To request text translations, follow the steps below. Note that this process may take two weeks or more to complete.

  1. In the Dev Portal, ensure your entities (i.e., store settings, offers, and pages) have been completed in English.
  2. Download the localization template by following the process described in Step 1: Download the Localization Template.
  3. Contact support to submit a request for text translation. Ensure you attach the downloaded localization template to the request. Note that it may take 2 weeks or more to receive your translations.
  4. Once you have your translations, follow the Create Text Localizations process to publish your localizations.

Asset Localization (Image and Video)

In addition to text-based localization, the Epic Games Store also supports localizing media assets. With asset localization, you can customize the store experience for users based on their selected locale and present them with images and videos in their preferred language.

Create Asset Localizations

Before you begin, ensure the entities (e.g., offers, pages, etc.) that you intend to localize have been configured in English. Additionally, these entities must be in the Dev sandbox with a Ready for Stage status. To learn more about sandboxes and statuses, review Release Management.

Once your entities are ready, complete the following process for media asset localization:

  1. Upload localized assets
  2. Publish localized assets

Step 1: Upload Localized Assets

Follow the steps below to upload assets to an entity for a specific locale. Repeat this process as needed for additional locales and entities.

  1. In the Dev Portal, navigate to Your Product > Epic Games Store > Localization.
  2. Ensure the Dev sandbox is selected. Then, click the name of an entity to edit.
  3. Choose the language you wish to configure from the options on the right. If the desired language is not available, click Add New Language and select the appropriate option to add it to the list.
  4. In the Media Localization section, select a component to configure (e.g., Offer Images). Then, upload your localized assets as needed.
  5. On the Localize Media screen, click Preview in Store to launch a storefront preview in a new tab. Note that this option may not be available for all entities.
  6. Click Save Changes to finalize the upload.

Once you have uploaded and reviewed your localized assets, continue to Step 2: Publish Localized Assets.

Notes:

  • Assets associated with a specific language have the Localized label, while assets copied from the original English configuration display the Default label. If you make any unintended edits, click Use Original Media to revert to the default assets for that section.
  • If you update an asset in English that has previously been localized, you are given the option to either Update All or Update Non-Localized Only. If you select Update Non-Localized Only, then all assets associated with an entity for a given locale are no longer counted as Default and instead display as Localized.

Step 2: Publish Localized Assets

To publish your localized assets, you first must push the localized entities to the Stage sandbox and submit them for review. Once approved, you can then publish your changes to the Live sandbox.

  1. Navigate to Your Product > Epic Games Store > Release Management.
  2. In the Dev sandbox, click Push to Stage.
  3. Select the entities containing localized assets from the list.
  4. Click Push to Stage. The entities then display in the Stage sandbox section of the screen.
  5. In the Stage sandbox, click Submit for Review to submit your media to the Epic Games Store team.
  6. Once your entities have been approved, push your content to the Live sandbox by clicking Push to Live in the Stage sandbox.

After you have created one or more localizations, you can manage this information through the Dev Portal. For more information, review the Localization Management.

Note: During the review process, the Epic Games Store team may provide feedback that requires media changes in English. In this scenario, you must also update any associated localized assets before resubmitting your entities for review.

Localization Management

Once localizations have been created for your product, you can review that content, remove specific language support, and access a history of your template uploads through the Dev Portal.

Review Content or Remove Language Support

To review existing localized content or remove specific language support, follow the steps below:

  1. In the Dev Portal, navigate to Your Product > Epic Games Store > Localization.
  2. Click the name of an entity to access its Manage Localization screen. From here, you can:
    • Review localized content: First, select a language from the list on the right. Then, choose the option for either Text or Media Localization to review the entity's content.
    • Remove language support: To remove all content associated with a specific locale from the entity, click the Delete icon to the right of the language. This action deletes both text and media asset localizations and cannot be undone. Once deleted, entities are replaced with default images and English text.

Note: The Add New Language option available on the Manage Localization screen only supports uploading localized media assets; it does not support text localization. To translate text-based content, you must follow the Create Text Localizations process.

View Localization Upload History

In the Dev Portal, a history of localization templates your organization has uploaded is available. This history includes details such as file names, upload dates, locales added, statuses of uploads (i.e., if an upload was successful or had issues), and any associated errors.

To access your localization upload history, navigate to Your Product > Epic Games Store > Localization and click the Localized File History (clock) icon to the top right.