{"_id":"55a4ff9b750a9a23005332b3","project":"5540ce1b31827a0d007ab1cc","category":{"_id":"55a4ff5b2e70c0250038050f","pages":["55a4ff7d750a9a23005332af","55a4ff8b750a9a23005332b1","55a4ff9b750a9a23005332b3","55a60bfcaaf9cf1900114efb","55a6184880c8a30d00b32526","55a61ba780c8a30d00b32532","55a61c97aaf9cf1900114f40","55a61ea9aaf9cf1900114f48","55a6206580c8a30d00b32544","55a64277aaf9cf1900114fc2","55a694d1aaf9cf1900115102","55a6a23eaaf9cf19001151e2","55a6a9b389c9da1900e2a41d","55a6aba45f88a70d0065b255","55a90687c8bd450d000dd157","55af84f3aa902f1700300daa","55afa3e3902fd51700f5f858","55b0cc5cb3171b3700b153fa","56015bdc3aa0520d00da0ced","5603fe3490ee490d004404c2","5633dd18d28a340d004004f5","56448c697a8cb50d00a3ea3f","56d7a2ec5208281500a2506c","56d859b8b159f10b00304577","56d9822add90610b002708a1","56ef44c6e8d6fa17006f244f"],"version":"5540ce1c31827a0d007ab1cf","project":"5540ce1b31827a0d007ab1cc","__v":26,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-07-14T12:23:55.603Z","from_sync":false,"order":2,"slug":"features","title":"Features"},"parentDoc":null,"__v":11,"user":"5540cdbf5cf9682100d61a97","version":{"_id":"5540ce1c31827a0d007ab1cf","project":"5540ce1b31827a0d007ab1cc","__v":31,"createdAt":"2015-04-29T12:27:08.390Z","releaseDate":"2015-04-29T12:27:08.390Z","categories":["5540ce1c31827a0d007ab1d0","5540d91bbb9e762d00f594ad","5540e5f131827a0d007ab212","5540e5febb9e762d00f594d3","5540e61331827a0d007ab213","5540e6195cf9682100d61afa","5540e62631827a0d007ab214","5540e63031827a0d007ab215","5540e63531827a0d007ab216","5540e63e5cf9682100d61afc","5540e6445cf9682100d61afd","5540e64a5cf9682100d61afe","55a4ff5b2e70c0250038050f","55acb28318eefd0d0071d504","55ae1abe8576b92300291c80","55ae453ef302af23000ac109","55af586d555b900d0036d296","55af91dac8a85321007a53c3","55b9fee204775a2f00628071","55b9ff0e04775a2f00628072","55b9ff4604775a2f00628073","55b9ff5fd72d1e1900276a38","55b9ff7f04775a2f00628074","55b9ff90eb08801900f833e5","55b9ffa5d72d1e1900276a39","55b9ffca04775a2f00628075","55b9fffdd72d1e1900276a3a","56bc2f033ee9e70d008b46af","56c2f6efbbf9ec2d00e0fe4f","57595bbb18760817001e8bbe","57d8d9793916800e003dde53"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-07-14T12:24:59.115Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"One of the many unique features of Pushwoosh lets you send multi-language messages within one single push. Since Pushwoosh always knows which language is set on each of your subscribed devices, it will suggest you the most popular languages in your database for consideration. Based on this information, you can create a couple (three, five, ten…) versions of your text in order to overcome language barriers, especially for multi-national apps.\n\nThe implementation is as easy as it seems. When you create your new push, see the languages shown right below the main text area. You will see the list of top ten languages registered for your app.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/G9xos84SJeEo0M3K69Vg_fig1.png\",\n        \"fig1.png\",\n        \"859\",\n        \"434\",\n        \"#22a09d\",\n        \"\"\n      ],\n      \"caption\": \"Figure 1. Choose your popular languages.\"\n    }\n  ]\n}\n[/block]\nClick on each language to open the text editor area for this particular locale and enter your customized messages (see *Figure 2*). You can add as many languages as you want, and they will all be sent out within one push with the rest of the data at the same time.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/Ca9toVMFRqeCsVXVW1p5_Fig2.png\",\n        \"Fig2.png\",\n        \"863\",\n        \"439\",\n        \"#259f9e\",\n        \"\"\n      ],\n      \"caption\": \"Figure 2. Add different message versions.\"\n    }\n  ]\n}\n[/block]\nDo not forget about the payload limitations for some of the platforms! Different languages are using different alphabets, and while your English version may fit in nicely, the push in Arabic text may exceed iOS quota.\n\nIn order to verify how many versions you have added, please see the **Push Summary** before sending the push out.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/2ahImQ0SnymYhwHG6X0m_Fig3.png\",\n        \"Fig3.png\",\n        \"727\",\n        \"298\",\n        \"#b5763f\",\n        \"\"\n      ],\n      \"caption\": \"Figure 3. Push Summary\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"success\",\n  \"body\": \"Language tag value is a *lowercase* two-letter code according to the [ISO-639-1](http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)\",\n  \"title\": \"Language Code Standard\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"\",\n  \"body\": \"Without additional filters and conditions, this push will be delivered to ALL your subscribers, according to their language locale. The subscribers, who speak a language not covered by your multi-language message, will receive the English version of your push (the one entered in the ‘en’ field).\"\n}\n[/block]\nThis feature is also available in our [Remote API](https://www.pushwoosh.com/programming-push-notification/pushwoosh-push-notification-remote-api/) as a parameter of the `createMessage` request:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"  \\\"content\\\": {\\n        \\\"en\\\": \\\"HelloWorld!\\\",\\n        \\\"es\\\": \\\"¡HolaMundo!\\\"\\n    },\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nYes, it’s as easy as it seems!\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"If you want to see the full stats for your currently registered languages, check out the [stats for your Tags](https://www.pushwoosh.com/programming-push-notification/features-guides/advanced-stats/).\"\n}\n[/block]","excerpt":"","slug":"multi-language","type":"basic","title":"Multi-Language"}
One of the many unique features of Pushwoosh lets you send multi-language messages within one single push. Since Pushwoosh always knows which language is set on each of your subscribed devices, it will suggest you the most popular languages in your database for consideration. Based on this information, you can create a couple (three, five, ten…) versions of your text in order to overcome language barriers, especially for multi-national apps. The implementation is as easy as it seems. When you create your new push, see the languages shown right below the main text area. You will see the list of top ten languages registered for your app. [block:image] { "images": [ { "image": [ "https://files.readme.io/G9xos84SJeEo0M3K69Vg_fig1.png", "fig1.png", "859", "434", "#22a09d", "" ], "caption": "Figure 1. Choose your popular languages." } ] } [/block] Click on each language to open the text editor area for this particular locale and enter your customized messages (see *Figure 2*). You can add as many languages as you want, and they will all be sent out within one push with the rest of the data at the same time. [block:image] { "images": [ { "image": [ "https://files.readme.io/Ca9toVMFRqeCsVXVW1p5_Fig2.png", "Fig2.png", "863", "439", "#259f9e", "" ], "caption": "Figure 2. Add different message versions." } ] } [/block] Do not forget about the payload limitations for some of the platforms! Different languages are using different alphabets, and while your English version may fit in nicely, the push in Arabic text may exceed iOS quota. In order to verify how many versions you have added, please see the **Push Summary** before sending the push out. [block:image] { "images": [ { "image": [ "https://files.readme.io/2ahImQ0SnymYhwHG6X0m_Fig3.png", "Fig3.png", "727", "298", "#b5763f", "" ], "caption": "Figure 3. Push Summary" } ] } [/block] [block:callout] { "type": "success", "body": "Language tag value is a *lowercase* two-letter code according to the [ISO-639-1](http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)", "title": "Language Code Standard" } [/block] [block:callout] { "type": "warning", "title": "", "body": "Without additional filters and conditions, this push will be delivered to ALL your subscribers, according to their language locale. The subscribers, who speak a language not covered by your multi-language message, will receive the English version of your push (the one entered in the ‘en’ field)." } [/block] This feature is also available in our [Remote API](https://www.pushwoosh.com/programming-push-notification/pushwoosh-push-notification-remote-api/) as a parameter of the `createMessage` request: [block:code] { "codes": [ { "code": " \"content\": {\n \"en\": \"HelloWorld!\",\n \"es\": \"¡HolaMundo!\"\n },", "language": "json" } ] } [/block] Yes, it’s as easy as it seems! [block:callout] { "type": "info", "body": "If you want to see the full stats for your currently registered languages, check out the [stats for your Tags](https://www.pushwoosh.com/programming-push-notification/features-guides/advanced-stats/)." } [/block]