Localization

Search, add, edit, delete store string resources by language, and bulk export/import with Excel.

The Localization screen is where you manage the per-language equivalents (string resources) of the texts used in your store's storefront. Each resource consists of a Source name and its Value in that language; you use this screen to change a storefront text or add a translation for a new language. Besides editing individually, you can export all resources of a language to Excel, bulk edit, and then import back. It is intended for content and e-commerce teams.

Accessing the screen

Follow the menu path CMS – Headless Content › Localization. If you do not see it in the menu, your account does not have permission for this screen.

Alternatively, you can come from: clicking the String resources icon in a language row on the Settings & Authorization › Languages screen or the Open this language’s string resources link in the language edit window opens this screen with that language selected. These links do not carry setup information: the screen always opens with the Default setup. If you work with another setup on the Languages screen, set Setup here to the same setup, reselect the language, and press Filter.

The Add resource, Import from Excel, edit, and delete buttons appear only for accounts with permission to modify string resources. If you do not see them, you can only view the screen and export with Export to Excel.

Screen sections

1. Page title Localization, below it the description "Store string resources; name and value per language."; on the right, buttons Export to Excel, Import from Excel, and Add resource.
2. If no language is selected yet, a yellow warning bar: Pick a language to see its resources.
3. Filter area: setup (visible if multiple setups exist), language, source name, and resource value fields; below them Clear and Filter buttons.
4. List: above it, Per page selector, Filter result: … records counter, refresh icon, and Columns menu; below it pagination.

Filtering and searching

The list does not populate until you select a Language and apply the filter because string resources are stored per language.

Filters apply when you press Filter (or Enter while in a field). If both Source name and Resource value are filled, only resources matching both are listed. Clear empties all filters including setup and language; since language selection is cleared, the list empties and the language selection warning reappears.

List

Resources without a value show "—" in the cell. Page size can be 50, 100, or 200; default is 50. Sorting by clicking columns is not supported. Clicking a row does nothing; use the pencil icon to edit.

Actions

Adding a resource

Use when you want to assign a value in the selected language to a new storefront text key.

1. Select a language in the Language field and press Filter. The Add resource button is disabled if no language is selected.
2. Press Add resource. The New string resource window opens.
3. Enter the key in the Source name field. Store resources are searched in lowercase, so the name is saved in lowercase.
4. Enter the text in the Value field.
5. Press Save. The button is disabled if Source name is empty.

The resource is added to the language selected in the filter; the window does not ask for language again. On success, a "Saved" notification appears, the window closes, and the list refreshes. If a resource with the same name already exists in this language, a "A resource with the same name already exists in this language" warning appears and the window stays open; change the name or find and edit the existing resource in the list. Cancel closes the window without saving.

Editing a resource

1. Press the Edit (pencil) icon in the row. The Translation resource window opens with the current name and value.
2. Change the Value (and Source name if needed).
3. Press Save.

The result and error behavior are the same as adding. If you rename to a name that already exists, you get the "A resource with the same name already exists in this language" warning.

Deleting a resource

1. Press the Delete (trash) icon in the row.
2. Read the warning "The “…” resource will be deleted. This action cannot be undone." in the popup.
3. Confirm with the red Delete button or exit with Cancel.

On success, a "Deleted" notification appears and the list refreshes. Deleted resources cannot be restored. Deleting removes only this record in the selected language; counterparts in other languages are managed separately by selecting those languages.

Exporting to Excel

Use to download all string resources of the selected language into an Excel file; also useful as a starting file for bulk editing.

1. Select a Language and press Filter. The Export to Excel button is disabled if no language is selected.
2. Press Export to Excel. The button shows Preparing… while the file is generated.
3. The file downloads to your browser and a "Excel file downloaded (… records)" notification appears. The filename includes the language code and date (ceviriler-<language code>-<date>.xlsx).

The file contains all resources of the selected language regardless of Source name and Resource value filters. The first sheet has two columns titled ResourceName and ResourceValue; this format matches the import. If the record count exceeds the single file limit, a yellow notification appears with "Limit exceeded; file contains only the first records. Narrow the filter and export again." In this case, the file does not contain all resources of the language. Because export ignores filters, narrowing by Source name or Resource value does not reduce file size.

Importing from Excel

Use to add or update many resources at once. Import is two-step: first the file is previewed, nothing is written before your confirmation.

1. Select a Language and press Filter. The resources in the file will be written to this language.
2. Press Import from Excel. The Import translations — <language name> window opens.
3. Check the format described in the window: the first row of the first sheet is header; column A is source name, column B is resource value.
4. Drag and drop or click to select the file in the Choose a file or drop it here area. Preview runs immediately after file selection.
5. Read the preview results: counts of To add, To update, Unchanged, and Skipped. If any rows are skipped, a table with Rows and Reason columns explains why.
6. If the results are acceptable, press Import (… writes). The write count is the sum of resources to add and update.

After writing completes, a "Import completed" notification appears with counts of added, updated, unchanged, and skipped; the window closes and the list refreshes. If no changes to write exist in the file, a "No changes to write in the file." warning appears and the Import button is disabled. The window cannot be closed during the operation.

File rules:

• Only .xlsx files are accepted; other extensions show "Only .xlsx files are accepted." warning.
• File size max 16 MB; max 10,000 filled rows can be imported at once.
• Only the first sheet is read. The first row is header; completely empty rows are skipped.
• Leading and trailing spaces in source names are trimmed and the name is converted to lowercase. Values are taken as-is; leading or trailing spaces are preserved.
• If a resource with the same name exists in this language, its value is updated; otherwise, a new resource is added.

Reasons for skipped rows:

Import adds and updates resources; to remove a resource, use the Delete icon in the list.

The safest way for bulk editing: first download the file with Export to Excel, change values in the file, then upload the same file with Import from Excel. Only rows you changed appear as To update in the preview.

Common situations

• List is empty and says "Pick a language to see its resources". No language selected yet. Select a language in the Language field and press Filter.
• List is empty and says "No translation resource". No resources match your search in the selected language. Loosen Source name or Resource value filters or press Clear and reselect the language.
• The language I want is not in the language list. Languages are defined per setup. If you have multiple setups, select the correct Setup and press Filter. If the language is not defined at all, add it first on the Settings & Authorization › Languages screen.
• I typed a source name with uppercase letters but it saved in lowercase. This is expected; store resources are searched in lowercase, so names are converted to lowercase.
• I do not see add, import, or edit buttons. Your account lacks permission to modify string resources; you can only view and export.
• Import error "No data rows in file (1st row is header)". The first sheet has no filled rows after the header. Ensure data is on the first sheet starting from row 2.
• File error shown in import window. The window checks the file before preview: "File too large (max 16 MB)" split the file; "File unreadable; must be .xlsx format" save the file as .xlsx in Excel (old .xls not accepted); "Max 10,000 rows per import" split the file and upload parts sequentially.
• I came from the Languages screen but the list is empty. If you work with a non-default setup on the Languages screen, this screen still opens with Default setup. Change Setup, reselect the language, and press Filter.

Related screens

• Languages
• URL redirects
• Store menus
• Overview
• Using list screens