Translations for Confluence Cloud

Using Translations Macros with Content Restrictions

If you use page-level restrictions in Confluence, Translations for Confluence macros need additional access to render and switch languages correctly. This applies to pages and blog posts.

The workaround is simple: Grant the Translations for Confluence app user access to the restricted content before you publish or save it.

Important: Always add the app user to the restrictions before saving or publishing the page or blog post. The app user requires write access during saving / publishing; adding access afterward will not enable the Translations macros.

Without this additional permission, the app will not be able to render the language macros on restricted content. The language selection doesn't work either.

What you need to do

Add the Translations for Confluence app user to the content restrictions and give it edit access.

image-20260803-135143.png
image-20260803-134920.png

Step-by-step instructions

  1. Open the page or blog post you want to edit or create a new one.

  2. Add or remove your language macros as usual.

  3. Open the Restrictions settings for the content.

  4. Restrict access as needed.

  5. Add the Translations for Confluence app user to the restriction settings.

  6. Grant the app user edit permission.

  7. Save the restriction settings.

  8. Only then save your changes or publish the page or blog post.

Now, users who already have access to the page or blog post can view the correctly rendered language macro content and switch between the available languages.

FAQ

Does this give the app access to all pages in my space?

No. The permission applies only to the specific page or blog post where you add the app user.

Does this affect data storage or processing?

No. Granting this permission does not change how data is stored or processed. It only allows the app to access the restricted content so the macros can function correctly there.

Does this work for both pages and blog posts?

Yes. This workaround applies to both Confluence pages and blog posts with page-level restrictions.