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 |
---|---|
English | en |
Arabic | ar |
French | fr |
German | de |
Italian | it |
Japanese | ja |
Korean | ko |
Polish | pl |
Portuguese (Brazil) | pt-BR |
Russian | ru |
Spanish (Spain) | es-ES |
Spanish | es |
Thai | th |
Turkish | tr |
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, complete the required fields for the entities you intend to localize (e.g., offers, pages, etc.) in English. English content populates the localization template and is required for all products distributed on the Epic Games Store. Additionally, ensure these entities are in the Dev sandbox with a Ready for Stage status. (To learn more about sandboxes and statuses, review Release Management.)
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:
- Download the localization template
- Complete the localization template
- Import Localizations
- Preview your localizations
- 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:
- In the Dev Portal, navigate to Your Product > Epic Games Store > Localization.
- Ensure the Dev sandbox is selected. Then, click Download Template.
- 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:
- Download the Product Home template and provide localizations for all locale columns. Upload Product Home Page template.
- 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 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. Additionally, ensure you remove any unused locale columns prior to uploading the template, or the import may result in an error.
To complete the localization template, follow the steps below:
- In the .CSV file, review the
Localization Field
,Field Description
, anden
columns to identify the strings requiring translation. - For each string, add your translated content to each locale column as needed.
- Remove any locale columns that are not being used. Your completed file should only include locale columns that contain translated content.
- Note: If any unused columns are not removed prior to uploading your template, the import may result in an error.
- 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:
- In the Dev Portal, navigate to Your Product > Epic Games Store > Localization.
- 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.
- Navigate to Your Product > Epic Games Store > Localization.
- In the Dev sandbox list, click the entity you wish to preview.
- Select a language from the list to the right. Then, click Text.
- Fields containing localized content then display. Click Preview in Store to the top right to launch a storefront preview in a new tab.
- Review the preview to ensure your localized content displays as desired. When ready, continue to Step 5: Publish Localizations
- Tip: To update any content, return to Step 2: Complete the Localization Template and Step 3: Import Localizations as needed.
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.
- Navigate to Your Product > Epic Games Store > Release Management.
- In the Dev sandbox, click Push to Stage.
- Select the entities containing new localizations from the list.
- Click Push to Stage. The entities then display in the Stage sandbox section of the screen.
- In the Stage sandbox, click Submit for Review to submit your content to the Epic Games Store team.
- 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.
- In the Dev Portal, ensure your entities (i.e., store settings, offers, and pages) have been completed in English.
- Download the localization template by following the process described in Step 1: Download the Localization Template.
- Create a private discussion on our Developer Support site 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.
- 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, configure the entities you intend to localize (e.g., offers, pages, etc.) in English. Additionally, ensure these entities are 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:
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.
- In the Dev Portal, navigate to Your Product > Epic Games Store > Localization.
- Ensure the Dev sandbox is selected. Then, click the name of an entity to edit.
- 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.
- In the Media Localization section, select a component to configure (e.g., Offer Images). Then, upload your localized assets as needed.
- Tip: While updating your assets, click Preview in Store to launch a preview of your storefront in a new tab. Use this preview to ensure your localized assets display as desired on your product pages. Note that this option may not be available for all entity types.
- 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.
- Navigate to Your Product > Epic Games Store > Release Management.
- In the Dev sandbox, click Push to Stage.
- Select the entities containing localized assets from the list.
- Click Push to Stage. The entities then display in the Stage sandbox section of the screen.
- In the Stage sandbox, click Submit for Review to submit your media to the Epic Games Store team.
- 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:
- In the Dev Portal, navigate to Your Product > Epic Games Store > Localization.
- 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.