CSV / XLSX 文件配置

After uploading CSV or XLSX files to a file-based project, they require additional configuration before the system can import the content of these files.

To configure CSV or XLSX files in a file-based project, follow these steps:

  1. Open your project and go to Sources > Files.
  2. 点击文件旁边的 配置,打开配置窗口。


The configuration process is similar in a string-based project as well. CSV or XLSX files require additional configuration before they are uploaded to the project.

To configure CSV or XLSX files in a string-based project, follow these steps:

  1. Open your project and go to the Upload tab.
  2. Drag and drop files from your machine.
  3. 点击文件旁边的 配置,打开配置窗口。

Configure File (String-based)

本条中提到的相同配置也适用于 TSV 文件格式。 The main difference between CSV and TSV files is that they use different delimiters between columns (i.e., commas in CSV and tabs in TSV).

XLSX 文件的配置选项

配置 XLSX 文件时,将提供以下选项:

  • 导入所有单元格——将每个单独的单元格作为独立的源字符串导入。 此外,您可以使用内容分割将源文件的内容分割为较短的文字内容,主要是句子和短段落。 这有助于翻译包含若干句子的内容单元,因为翻译较小篇幅的文本更加容易些。 将使用 Segmentation Rules eXchange (SRX) 进行自动的内容分割。

  • 配置导入的列——指定首选的列顺序。

XLSX 配置选项

配置 XLSX 和 CSV 文件导入的列

When configuring CSV or XLSX file with Configure columns for import option, you can specify the following column types:

  • Key – Column contains string identifiers. Typically an alphanumeric value.
  • Source string – Column contains source strings that should be translated.
  • Source string/Translation – Column contains source strings, but the same column will be filled with translations when the file is exported. When uploading existing translations, the values from this column will be used as translations.
  • Translation – Column for resulting translations added on export. On import and when uploading existing translations, the system will check this column for existing translations and upload them to the project.
  • Context – Column contains comments or context information for the source strings.
  • Labels – Column contains labels for the source strings. You can add multiple labels to each string, separating them with commas.
  • Max. Length – Column contains max.length limit values for the translations of the strings.
  • Not chosen – Column that will be skipped on import.

CSV 配置

Automatic Column Identification

Once you open the configuration dialog for source files in CSV or XLSX formats, the system automatically detects the file scheme based on the column names specified in the first row. The identification is performed in a case-insensitive manner. Columns that weren’t detected automatically will be left as Not chosen for manual configuration. Automatic column identification is especially helpful when you upload multiple multilingual spreadsheets that contain many languages and additional columns (e.g., Context, Labels, Max. Length).

To get the most out of the automatic column detection, we recommend that you name the columns in your CSV or XLSX source files using the values displayed in the table below:

Column type Expected value
键名 identifier, key
源字符串 source phrase, source_phrase, source string, source_string
Source String/Translation source or translation, source_or_translation, source/translation
翻译 译文
语境 context
标签 标签
Max. 长度 max. length, max_length
语言(用于多语言文件) 语言名称 (例如:简体中文), Crowdin 语言代码,语言代码(例如:zh-CN),带下划线的语言代码(例如:zh_CN) 语言代码 ISO 639-1(例如:zh),语言代码 ISO 639-2/T(例如:zho)

By default, during scheme configuration, the system treats CSV and XLSX source files as monolingual. To autodetect file scheme for multilingual source files, follow these steps:

  1. 选择 多语言电子表格
  2. Click More and select Detect Configuration.


If multiple files have the same configuration scheme, save your current configuration as a template by clicking Templates > Save as template, then specify the template name and click Save. You’ll be able to apply the template to the newly imported files.


If you don’t want to translate the column headers, select Do not import the first row (header).

Note: The Do not import the first row (header) option is automatically selected if the automatic scheme detection identifies all columns in the source file.



If you’d like to start the spreadsheet configuration over, click More and select Reset Configuration.


If your file contains several columns with translations into different languages, select Multilingual Spreadsheet and map the languages to the appropriate columns.

By default, when you configure the multilingual spreadsheets, the Import translations option is selected. If you’d like not to import the existing translations from the file, you can clear this option.

如果您的多语言源文件没有足够的列用于所有项目目标语言,请点击添加列。 To remove one of the added columns, click More and select Delete Selected Column.

多语言 CSV


To configure several selected CSV or XLSX files, right-click and select Configure files.

CSV 配置

To configure all CSV or all XLSX files at once, click Configure All.

CSV 配置

In the configuration window, you’ll be able to switch between the selected files to preview and verify if the applied configuration is correct for all files.

Changing Scheme for CSV and XLSX Files

You might want to update CSV or XLSX files and change the initially configured scheme. The scheme update might be needed when you add a new target language to your Crowdin project.

To change the scheme for your source file, follow these steps:

  1. Right-click on the needed files and select Change scheme.
  2. 选择您机器上的新文件。
  3. Set the new configuration/template for the file correspondingly.
Note: You can't edit the existing configuration template. 相反,您可以删除它或新建一个。