diff --git a/crowdin.yml b/crowdin.yml
index 95c0b8bc..be4e256d 100644
--- a/crowdin.yml
+++ b/crowdin.yml
@@ -1,8 +1,30 @@
-preserve_hierarchy: 
-files:
-  - source: /locales/en/messages.json
-    translation: /locales/%two_letters_code%/%original_file_name%
-    languages_mapping:
-      two_letters_code:
-        pt-BR: pt_BR
-        zh-CN: zh_CN
+#
+# Files configuration
+#
+"preserve_hierarchy": false
+
+files: [
+ {
+  #
+  # Source files filter
+  # e.g. "/resources/en/*.json"
+  #
+  "source" : "/locales/en/messages.json",
+
+  #
+  # where translations live
+  # e.g. "/resources/%two_letters_code%/%original_file_name%"
+  #
+  "translation" : "/locales/%two_letters_code%/%original_file_name%",
+
+  #
+  # Often software projects have custom names for locale directories. crowdin-cli allows you to map your own languages to be understandable by Crowdin.
+  #
+  "languages_mapping" : {
+    "two_letters_code" : {
+      "pt-BR" : "pt_BR",
+      "zh-CN" : "zh_CN"
+     }
+  }
+ }
+]