{"id":3711,"date":"2021-10-27T21:11:11","date_gmt":"2021-10-27T18:11:11","guid":{"rendered":"https:\/\/creativethemes.com\/blocksy\/?post_type=documentation&#038;p=3711"},"modified":"2026-08-27T14:52:18","modified_gmt":"2026-08-27T11:52:18","slug":"how-to-translate-blocksy","status":"publish","type":"documentation","link":"https:\/\/creativethemes.com\/blocksy\/docs\/general\/how-to-translate-blocksy\/","title":{"rendered":"How to Translate Blocksy"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Blocksy is fully translation-ready and uses WordPress&#8217; standard localisation system. The Blocksy theme, Blocksy Companion and Blocksy Companion Pro can all be translated into your preferred language using standard translation tools.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If you would like to contribute translations for everyone, you can use the community translation platforms described below. If you only need a translation for your own website, tools such as Loco Translate or Poedit can be used instead.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Contributing Community Translations<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The free Blocksy theme and Blocksy Companion plugin are distributed through WordPress.org, so their community translations are managed through the official WordPress translation platform.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Blocksy Theme<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">You can contribute translations for the Blocksy theme through the <a href=\"https:\/\/translate.wordpress.org\/projects\/wp-themes\/blocksy\/\" target=\"_blank\" rel=\"nofollow noreferrer noopener\">Blocksy translation project on WordPress.org<\/a>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Select your language to view its current translation status and contribute any strings that are still missing. You will need a free WordPress.org account to submit translations.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Blocksy Companion<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Translations for the free Blocksy Companion plugin are managed separately through the <a href=\"https:\/\/translate.wordpress.org\/projects\/wp-plugins\/blocksy-companion\/\" target=\"_blank\" rel=\"nofollow noreferrer noopener\">Blocksy Companion translation project on WordPress.org<\/a>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The process is the same as for the theme &#8211; choose your language, open the appropriate translation set and submit translations for the available strings.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Using the WordPress.org Translation Platform<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Each WordPress.org translation project provides an overview of the available languages and their current completion status.<\/p>\n\n\n\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;6a9a17891f259&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"6a9a17891f259\" class=\"wp-block-image size-large has-lightbox wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/creativethemes.com\/blocksy\/wp-content\/uploads\/2021\/10\/Screenshot-2021-10-27-at-22.13.44-1024x553-1.png\" alt=\"Blocksy translation project on WordPress.org showing the available languages\" \/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\tdata-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.thisImage.buttonRight\"\n\t\t\tdata-wp-style--top=\"state.thisImage.buttonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><figcaption class=\"wp-element-caption\">The Blocksy translation project on WordPress.org.<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The completion percentage shows how much of the project has already been translated for each language. Languages with incomplete translations can be improved by community contributors.<\/p>\n\n\n\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;6a9a17891fa64&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"6a9a17891fa64\" class=\"wp-block-image size-large has-lightbox wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/creativethemes.com\/blocksy\/wp-content\/uploads\/2021\/10\/Screenshot-2021-10-27-at-22.14.56-1024x849-1.png\" alt=\"Translation completion information for a Blocksy language on WordPress.org\" class=\"wp-image-3722\" \/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\tdata-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.thisImage.buttonRight\"\n\t\t\tdata-wp-style--top=\"state.thisImage.buttonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><figcaption class=\"wp-element-caption\">Translation progress for an individual language.<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">After selecting a language, open the relevant translation set to view the available strings. You can then enter your translations directly through the WordPress.org interface.<\/p>\n\n\n\n<figure class=\"wp-block-video\"><video autoplay loop muted src=\"https:\/\/creativethemes.com\/blocksy\/wp-content\/uploads\/2021\/10\/Screen-Recording-2021-10-27-at-22.29.16.mov\" playsinline><\/video><figcaption class=\"wp-element-caption\">Contributing a Blocksy translation through WordPress.org.<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Submitted translations may require approval from the translation editors responsible for that WordPress locale before they become part of an official language pack.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Translating Blocksy Companion Pro<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Blocksy Companion Pro is a commercial plugin and is therefore not distributed through the WordPress.org plugin repository. Its community translations are managed through our own GlotPress installation instead.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Visit <a href=\"https:\/\/translate.creativethemes.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/translate.creativethemes.com\/<\/a> and select the <strong>Blocksy Companion Pro<\/strong> project to get started.<\/p>\n\n\n\n<figure class=\"wp-block-video\"><video autoplay loop muted src=\"https:\/\/creativethemes.com\/blocksy\/wp-content\/uploads\/2021\/10\/Screen-Recording-2021-10-27-at-22.37.47.mov\" playsinline><\/video><figcaption class=\"wp-element-caption\">Translating Blocksy Companion Pro with GlotPress.<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Choose your language and open the available translation set to begin translating strings. Submitted translations are reviewed before being incorporated into Blocksy Companion Pro.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If you already maintain a translation in a <code>.po<\/code> file, GlotPress also supports importing those translations into the project. Imported strings remain subject to the same review process as translations submitted through the web interface.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Translating Blocksy for Your Own Website<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">You do not need to contribute your translation publicly if you only want to customise the wording used on your own website.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Loco Translate<\/strong> provides a convenient way to create and manage translations directly from the WordPress Dashboard. It can scan the available translation strings and generate the required translation files without requiring separate desktop software.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If you prefer working offline, applications such as <strong>Poedit<\/strong> can be used to edit standard WordPress <code>.pot<\/code> and <code>.po<\/code> translation files.<\/p>\n\n\n\n<p class=\"is-style-success coblocks-alert-paragraph has-palette-color-8-color has-palette-color-1-background-color has-text-color has-background has-link-color wp-elements-1 wp-block-paragraph\"><strong>Important<\/strong><br>When creating your own translations, avoid storing custom translation files directly inside the Blocksy theme or plugin folders. Those directories can be replaced during updates, which may remove your changes. Translation tools such as Loco Translate provide safe locations for custom translations.<\/p>\n\n\n\n<figure class=\"wp-block-embed is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<iframe loading=\"lazy\" title=\"Translating Blocksy with Loco Translate | Blocksy Integrations\" width=\"1290\" height=\"968\" src=\"https:\/\/www.youtube.com\/embed\/MRDu6BH22aA?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe>\n<\/div><figcaption class=\"wp-element-caption\">Translating Blocksy locally with Loco Translate.<\/figcaption><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>Blocksy is fully translation-ready and uses WordPress&#8217; standard localisation system. The Blocksy theme, Blocksy Companion and Blocksy Companion Pro can all be translated into your preferred language using standard translation tools. If you would like to contribute translations for everyone, you can use the community translation platforms described below. If you only need a translation [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"doc_categories":[111],"class_list":["post-3711","documentation","type-documentation","status-publish","hentry","doc_categories-general"],"blocksy_meta":{"styles_descriptor":{"styles":{"desktop":"","tablet":"","mobile":""},"google_fonts":[],"version":7}},"acf":[],"_links":{"self":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation\/3711","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation"}],"about":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/types\/documentation"}],"author":[{"embeddable":true,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/comments?post=3711"}],"version-history":[{"count":5,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation\/3711\/revisions"}],"predecessor-version":[{"id":15089,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation\/3711\/revisions\/15089"}],"wp:attachment":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/media?parent=3711"}],"wp:term":[{"taxonomy":"doc_categories","embeddable":true,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/doc_categories?post=3711"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}