Advanced Project Setup

You can configure project settings according to your needs in the Settings tab.

Naming

In the Naming section, you can change the project name, add a public description, and display social buttons.

Privacy

The Privacy section allows you to set preferred privacy settings using the following options:

• Project visibility

  • Public project – any user may search for the project and join it.
  • Private project – project can’t be found via search engines and Crowdin search, only the invited users can join the project.

• Require two-factor authentication for all the project members
  Select if you want to request project participants to enable two-factor authentication in their Account Settings > Password & Connections tab to access the private project.

• Moderated project joining
  Select if you want users to send requests to join the translation team of the preferred language. After the review, a project manager or proofreader can approve or decline the request. After joining the project, multilingual translators will be able to submit new requests to join translation teams in other target languages.

• Allow offline translation
  Select if you want to allow translators to download source files to their machines for offline translation and upload translations back into the project. Project owner and managers can always download sources and upload translations, not depending on the option status.

• Allow proofreaders to access hidden strings
  Select if you want to allow proofreaders to work with hidden strings. Project owner and managers can always work with hidden strings, not depending on the option status.

Badges

Embed badges into your website or README to share the localization progress of your project.

Source Language

If you want to change the source language for your project, select a new language from the drop-down list.

Here are a few points you should be aware of when changing the project’s source language:

• Please note that there might be a plural form mismatch for imported strings depending on the new source language. For example, some plural forms might not be displayed in the Editor, or some plural form translations might be used in other ones on translation export. We recommend updating the source files if the new source language has different plural forms than the initial one.
• If you had an opened browser tab with the Editor during the source language update, you might need to refresh it for changes to take effect and continue translating from the new source language.

Unify Placeholders

If your project contains iOS strings, iOS XLIFF, and Android XML files, you can enable the Unify placeholders option, and the system will transform placeholders into a unified look. For example, with the enabled Unify placeholders option, Android string Hello, %s! and the iOS string Hello, %@! will look in the Editor this way: Hello, [%s]!. This option is especially useful when you work with TM since TM suggestions from iOS strings, iOS XLIFF, and Android XML will be completely interchangeable. On export, the system will transform the placeholders in the translations back to the original format. This option is applied to iOS strings, iOS XLIFF, and Android XML formats only.

Save Context Information in the Files

If the Save context information in the files option is enabled, the context and max.length added in Crowdin will be visible in the downloaded files. This option is applied to CSV, Android XML, iOS strings, and RESX formats only.

Duplicate Strings

If your project contains duplicated strings, you can choose how the system should treat them:

• Show – translators will translate each instance (string) separately. Duplicated strings won’t be hidden.
• Show, but auto-translate them – Duplicated strings will be automatically translated but will stay visible to translators. Once the string is translated, its translation is automatically shared between the duplicates. Translators may review and re-translate those strings if necessary.
• Show within a version branch (regular detection) – duplicates will be hidden only between version branches.
• Show within a version branch (strict detection) – duplicates will be hidden only between version branches.
• Hide (regular detection) – all duplicates will share the same translation.
• Hide (strict detection) – all duplicates will share the same translation.

Regular duplicates detection - when comparing strings, Crowdin considers only source texts.
Strict duplicates detection - when comparing strings, Crowdin considers both string identifiers (keys) and source texts.

If your source files contain strings with apparent identifiers (keys), it’s better to use a strict version of the Duplicate Strings options. In other cases, feel free to use a regular one.

Machine Translation Suggestions

When the Show machine translation suggestions option is enabled, machine translation engines such as Microsoft Translator, Google Translate, and others will be displayed in the Editor. The project owner should configure machine translation engines before using them.

Allow Project Members to Manage Glossary Terms

If the Allow project members to manage glossary terms option is enabled, translators and proofreaders will be able to add new glossary terms to the project. Project owner and managers always can add and edit glossary terms, not depending on the option status.

Word count

With the Word count option, you can set the preferred way Crowdin should count words in your project. Specifically, it applies to whether HTML tags should be counted as regular words or not. By default, Crowdin considers HTML tags as regular words for most of the supported formats, excluding the following ones: HTML, Front Matter HTML, HAML, MD, Front Matter MD, XML, WEBXML, IDML, XLIFF, XLIFF 2.0, ADOC, DOCX, MIF, DITA.

• Auto (default) – HTML tags will be counted as regular words or skipped depending on the source file format.
• Count tags – all HTML tags will be counted as regular words.
• Skip tags – all HTML tags won’t be counted.

When you change the word count option, only newly uploaded words will be counted according to new settings. So it’s recommended to set the preferred word count settings before uploading source files to the project.

Export

By default, Crowdin uses source texts for the untranslated strings while exporting translations. You can configure export options using the following settings:

• Skip untranslated strings – only translated strings will be included in the exported translation files.

  This option works in three different ways, depending on the file format. For text formatted documents, this option is not applied since missing texts can make downloaded files unreadable. Others are exported with empty values. And for the third file category, untranslated strings are entirely removed from the exported translation files.

  Option not applied	Untranslated strings exported with empty values	Untranslated strings removed
  DOCX, IDML, DITA, ADOC, MD, MediaWiki, TXT, HAML, HTML, assets, FM MD, FM HTML, Contentful JSON, SVG	JSON (with nested structure), PHP, XLSX, CSV, FJS, RC, XAML, XML, Web XML, TypeScript, JS, TOML, QT TS, i18next JSON, gettext PO, FLSNP, Coffee	Android XML, macOS/iOS Strings, Stringsdict, Chrome JSON, JSON (without nested structure), YAML, XLIFF, XLIFF 2.0, ARB, DTD, RRC, GO JSON, Flex, Joomla INI, Maxthon, Java Properties, Play Properties, Java Properties XML, RES JSON, RESW, RESX, SBV, STR, STF, VTT, WXL, VDF, FBT JSON

• Skip untranslated files – only translated files will be included in the exported translation archive.

• Export only approved translations – only texts that are both translated and approved will be included in the exported translation files.
• Automatically fill in regional dialects – useful when the project is translated into the language dialects (e.g., Spanish, Argentina). Translations from Spanish will be automatically copied to untranslated strings in Spanish, Argentina during the download.
• Add custom language codes – use custom language codes for the exported translation files. This will keep the exported file structure consistent.

Adding Custom Language Codes

To add language mapping, follow these steps:

1. Open your project and go to the Settings tab.
2. Scroll down to the Export section.
3. Click Language Mapping.
4. Choose the necessary language and placeholder.
5. Add custom code.
6. You can map as many languages as you need. Click Add Mapping to add another custom code.
7. Click Save.

Bundles

In the Target Files Export section, you can add and configure bundles for exporting sets of strings in one of the selected formats. In simple words, bundles are the translation files that include sets of strings formed based on the specified patterns in the project settings. By default, you can choose from the following three formats: XLIFF, Android XML, and iOS Strings. Additionally, you can add more target file formats by installing respective applications from the Crowdin Marketplace.

The most common use cases are the following:

• You can upload a single source file (e.g., Android XML) to your project, translate it and then, using bundles, export translations for multiple platforms (e.g., Android XML for the Android app, iOS strings for the iOS app, JSON for the web app, etc.).
• You can have a single spreadsheet (e.g., XLSX or CSV) where you store source strings for all platforms your app is developed for, and each string is labeled with a respective label. Upload this file to your project, translate it, and then create separate bundles for multiple platforms using a combination of source file paths and string labels.
• You can export specific sets of strings for offline translation in XLIFF format and then upload finished translations back to Crowdin.

Configuring Bundles

To configure a bundle, follow these steps:

1. Open your project and go to the Settings tab.
2. Scroll down to the Target Files Export section.
3. Click Add bundle.
4. In the appeared dialog, select the file format you’d like your strings to be exported in. To add other formats, install the respective applications from our Marketplace.
   Note: You can select only one format at once within a single bundle.
5. Specify the source and translated file paths. If needed, you can add multiple source path patterns using . In the right panel, you can preview the structure of the source and translation files based on the specified paths.
6. (Optional) You can specify labels in the Labels field to filter strings that will be included in the bundle. Read more about Labels.
7. (Optional) To ignore some folders or files, click Add ignored pattern, specify the respective pattern for them, and Crowdin will skip these specific files or folders during the bundle generation. If needed, you can add multiple ignore patterns using .
8. Click Save.

Downloading Configured Bundles

You can download configured bundles either via your project’s Home tab or the Settings tab.

To download configured bundles via the Home tab, follow these steps:

1. Open your project and go to the Home tab.
2. Click on the drop-down toggle on the Build & Download button.
3. Click on the needed bundle in the Bundles section.

To download configured bundles via the Settings tab, follow these steps:

1. Open your project and go to the Settings tab.
2. Scroll down to the Target Files Export section.
3. Click Build towards the needed bundle.

The system will build and download a ZIP archive with folders for each of the project’s target languages containing the translation files of the selected format.

Editing Bundles

To edit configured bundles, follow these steps:

1. Open your project and go to the Settings tab.
2. Scroll down to the Target Files Export section.
3. Click towards the needed bundle and select Edit. Alternatively, just double-click on the needed bundle.
4. Do the necessary edits and click Save.

Deleting Bundles

To delete bundles, follow these steps:

1. Open your project and go to the Settings tab.
2. Scroll down to the Target Files Export section.
3. Click towards the needed bundle and select Delete.
4. Confirm the deletion by clicking Delete in the appeared dialog.

Translation Memory

Translation Memory is automatically enabled for each project. Which means that the approved or the latest translation for each string is stored under the project’s Resources > TM.

• Enable Auto-Substitution – the feature substitutes the non-translatable elements (such as tags, HTML entities, placeholders, numbers and more) in translations suggested by TM by the ones used in the source text. Improves TM suggestions applied during pre-translation and the ones shown as translation suggestions in the Editor. Improved suggestions are included in the Translation Costs report and the ones that can be improved are included in the Costs Estimation report.
• Use the global Translation Memory – translators will have access to the Global Translation Memory, where all translations from the projects with this feature enabled are stored.

Notifications

• Notify translators about new strings – translators will receive an email notification about newly added content for translation each time after the update. The Receive emails option should be activated in the translator’s profile.
• Notify project managers about new strings – project managers will receive an email notification about newly added content for translation each time after the update.
• Notify project managers about language translation/validation completion – project managers will receive the notification when some target language (all source files) is fully translated or fully validated.

Custom Domain

This option allows you to publish your Crowdin project on your own domain name.

To set up a custom domain:

1. Create a necessary domain in the domain name registrar.
2. Create CNAME record for this domain name that will be pointed to cname.crowdin.com.
3. Go to the Crowdin Project Settings, enter the created domain name into the Custom Domain field, click Update.

Project Logo

Upload your logo to customize the appearance of the main page of your project.

Delete Project

This option is accessible only to project owner. If necessary, you can delete your Crowdin project with all the translations and related localization resources.

See Also

• Changing Target Languages
• Adding Screenshots