{"id":299,"date":"2026-10-17T14:16:52","date_gmt":"2026-10-17T14:16:52","guid":{"rendered":"http:\/\/plugin-docs.com\/?post_type=doc&#038;p=299"},"modified":"2026-10-19T10:01:57","modified_gmt":"2026-10-19T10:01:57","slug":"translate-wordpress-post","status":"publish","type":"doc","link":"https:\/\/dragwyb.com\/docs\/translate-wordpress-post\/","title":{"rendered":"Translate a WordPress Post"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Use TranslateSense to translate an individual WordPress post into a language configured in Polylang. The translation workflow runs in the editor and processes content according to the detected editor type and its active mapping rules.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Before translating a post<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Open <strong>Posts \u2192 All Posts<\/strong> and locate the source post.<\/li>\n<li>Confirm that the source post has the correct Polylang language and that the target language is configured.<\/li>\n<li>Confirm TranslateSense has an active translation provider.<\/li>\n<li>Use the Polylang language controls to create or open the target-language version of the post. Keep the source and target linked as translations.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Translate the post<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Open the target-language post in the WordPress editor. TranslateSense needs to resolve its source post through the saved source ID or Polylang translation relationship.<\/li>\n<li>Select <strong>Translate Page<\/strong> in the TranslateSense control.<\/li>\n<li>In <strong>Choose Translation Provider<\/strong>, select an active provider that supports the target language.<\/li>\n<li>Wait for extraction and translation to finish, then review each source string, status, and translated value in <strong>Review Translations<\/strong>.<\/li>\n<li>Edit any translated text that needs correction, then select <strong>Apply to Page<\/strong>.<\/li>\n<li>Use WordPress&#8217;s <strong>Save<\/strong>, <strong>Update<\/strong>, or <strong>Publish<\/strong> action to persist the target post. Review the post on the frontend and confirm the Polylang translation relationship.<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">What gets translated?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The content parser selects the builder for the source post. Gutenberg blocks and Elementor widgets use their configured XML mappings; Classic Editor content uses the Classic Editor content builder. Only supported, mapped text is processed, and email addresses, URLs, and asset paths are excluded from the editor&#8217;s string-translation list. Review titles, excerpts, links, and any additional fields separately where they are exposed in the editor.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Troubleshooting<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>If the TranslateSense control is missing, check the post type&#8217;s Polylang translation support and the source-to-target relationship.<\/li>\n<li>If the provider cannot start, verify its credentials, connection status, model access, and target-language support.<\/li>\n<li>If text is skipped, inspect the relevant XML mapping and confirm the source post uses that editor or field.<\/li>\n<li>Do not assume that <strong>Apply to Page<\/strong> saves the WordPress post. Save the target post in WordPress after reviewing the editor.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">See <a href=\"\/docs\/ai-automatic-translation-addon-for-polylang\/setup-polylang-translation-pairs\/\">Set Up Polylang Translation Pairs<\/a> if the source and target posts are not linked correctly.<\/p>\n\n\n\n\n<p class=\"wp-block-paragraph\">Screenshot to add: [WordPress post editor showing the Polylang language relationship and TranslateSense control]<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Translate an individual WordPress post using TranslateSense.<\/p>\n","protected":false},"author":0,"featured_media":0,"parent":298,"menu_order":0,"template":"","class_list":["post-299","doc","type-doc","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/299","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc"}],"about":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/types\/doc"}],"version-history":[{"count":1,"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/299\/revisions"}],"predecessor-version":[{"id":1300,"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/299\/revisions\/1300"}],"up":[{"embeddable":true,"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/298"}],"wp:attachment":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/media?parent=299"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}