diff --git a/translation.rst b/translation.rst
index 8d965b78e73..33549a66f56 100644
--- a/translation.rst
+++ b/translation.rst
@@ -693,6 +693,13 @@ configure the ``providers`` option:
             ],
         ]);
 
+.. tip::
+
+    If you use Crowdin as a provider and some of your locales are different from
+    the `Crowdin Language Codes`_, you have to set the `Custom Language Codes`_ in the Crowdin project
+    for each of your locales, in order to override the default value. You need to select the
+    "locale" placeholder and specify the custom code in the "Custom Code" field.
+
 .. tip::
 
     If you use Lokalise as a provider and a locale format following the `ISO
@@ -1501,3 +1508,5 @@ Learn more
 .. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions
 .. _`pseudolocalization`: https://en.wikipedia.org/wiki/Pseudolocalization
 .. _`Symfony Demo`: https://github.com/symfony/demo
+.. _`Crowdin Language Codes`: https://developer.crowdin.com/language-codes
+.. _`Custom Language Codes`: https://support.crowdin.com/project-settings/#languages