RTL for Confluence
Setup & usage documentation

1. Overview

RTL for Confluence – Native RTL & Bulk Fix (previously referred to as RTL Pro) corrects right-to-left text that reads in the wrong order on Confluence Cloud pages — in the page body, the page title and the comments — and moves list markers to the right.

It rewrites the page’s own content in Confluence’s own format. There is no macro and no wrapper: your text stays ordinary page text, so it is still searched, still indexed, still exported, and still there if you ever remove the app.

Reading order, not alignment

This is the distinction the whole app rests on. Confluence’s toolbar already has an align-right button, and it writes the same alignment mark this app writes. Alignment decides which side of the page a block sits on. It says nothing about the order the words are read in, because Confluence’s storage format has no concept of text direction at all.

The same applies without any English in the sentence: an ordinary Arabic sentence ending in a full stop renders that full stop at the far right, before the sentence, until the reading order is corrected.

At a glance

2. Prerequisites

3. Installation

1. Open the app’s listing on the Atlassian Marketplace.
2. Click Try it free (or Buy now) and choose the Confluence site to install on.
3. Confirm the requested permissions. They are listed in full in section 4.
4. Wait for the install to complete. No configuration is required to start — the app ships with working defaults and automatic fixing already on.

Where the app appears

4. Permissions

The app requests six scopes, and no others:

Runs on Atlassian

The app declares no external domains and makes no network request to any third party. Your content is never sent anywhere outside Atlassian infrastructure, and the app stores no page content of its own — only your settings, the trial counter, and a record of which pages have been un-fixed.

The only outward links anywhere in the interface are the two buttons in the feedback prompt, “Rate on the Marketplace” and “Send private feedback”, which hand a URL to your browser when you click them.

5. Configuration

Go to Space settings → Integrations and find RTL defaults for this space.

The three defaults

These three are saved together by the Save button.

Automatic fixing

Below Save sits a separate switch: “Fix pages automatically when they are saved”, with the hint “When off, pages are only fixed when someone runs the check or the space scan.”

It is on by default and saves the moment you toggle it, rather than waiting for the Save button — this one switches automation that edits pages, so the effect of toggling it should be immediate and obvious.

How settings resolve

Settings are layered. A more specific layer wins, and layers that set nothing fall through to the one below:

An explicitly-off toggle in a higher layer beats an on toggle below it — switching something off is a real choice, not an absence of one.

6. Fixing One Page

This is the main entry point, and the fastest way to see what the app does. Nothing is written until you click the fix button.

1

Open the check

Open any page containing right-to-left text. Under the page title, in the byline row next to “Add a reaction”, click Right-to-left check. A popup opens and starts reading the page.

Checking this page…

Panel wording, reproduced — not a screenshot.

2

Read what it found

The panel lists every block that reads in the wrong order, with a preview of each, and reports the page title and comments separately because they are separate content.

4 blocks of right-to-left text read in the wrong order.

The page title reads in the wrong order.

1 comment needs fixing.

Panel wording, reproduced — not a screenshot.

3

Read the preview before you click

Nothing is written until you ask for it. The panel states exactly what the fix will and will not do, including where alignment cannot be applied.

These will be reordered to read right to left. Paragraphs and headings are right-aligned too, using Confluence’s own alignment, so that part of the fix stays even if this app is removed. Text inside lists and panels is reordered but cannot be right-aligned.

Saved as a new page version — use page history to undo.

Panel wording, reproduced — not a screenshot.

4

Apply it

Click Fix reading order. The page is saved as an ordinary new version, attributed to you — a manual fix runs with your own permissions, so the app can never change a page you could not edit by hand.

Fixed 4 blocks.

Reload page to see the change

Panel wording, reproduced — not a screenshot.

5

Reload and check

Reload the page. Arabic sentences now read in the correct order, paragraphs and headings sit on the right, and list markers have moved. Re-open the check and it reports the page as clean.

7. Fixing a Whole Space

Go to Space settings → Integrations and scroll to Fix every page in this space.

1. Click Scan this space. Progress is reported as it goes — “Scanning… 42 pages checked”.
2. Review the results. Every page that needs work is listed by name with how much will change on it — 3 blocks + title, 2 blocks, and so on. A page with an English title and an Arabic body is found just the same, because the scan reads bodies rather than titles alone.
3. Choose the pages you want, or use Select all, then click Fix 6 pages.
4. When it finishes you get the list back: every page it changed, by name, each one a link you can open and check. Comments on those pages are fixed too.

Why it runs in batches

Both loops are driven from your browser rather than the server. A Forge resolver has roughly 25 seconds to answer and there is no background queue, so the scan returns one cursor-paged slice at a time (25 pages per call, 50 at most) and a fix handles at most 10 pages per call. The interface makes many short calls and shows progress, which is why a large space completes instead of timing out half-way through.

Page bodies arrive alongside the space listing, so a scan costs one request per batch rather than one per page.

8. Undoing a Fix

Open Right-to-left check on a fixed page and click Remove RTL fix. It strips every character the app added, restores real Confluence lists where they were mirrored, and reverses the alignment it applied.

Afterwards the panel confirms:

That last clause matters: a page you have deliberately un-fixed is remembered, so automatic fixing does not undo your decision the next time someone saves it.

Page history works too

Every change the app makes — manual or automatic — is an ordinary Confluence page version with a descriptive message. You can see it in page history and roll it back with Confluence’s own tools, without involving the app at all.

9. Sample Test Document

A ready-made Arabic document for validating the app end to end. It is deliberately unfixed: it contains no Unicode bidirectional control characters and no alignment marks, so Confluence displays it with the defect intact — which is the point. You see the problem, then you fix it.

Step 1 — the page title

Create a new Confluence page and put this in the title field:

Step 2 — the page body

Copy the body and paste it into the page. The copy carries formatting, so headings, lists and the table survive the paste.

Step 3 — add a comment

Publish the page, then add this as a comment, so the check has a comment to report:

Step 4 — run the check and compare

Open Right-to-left check in the byline. This is what each element of the sample should do:

The English paragraph is the control worth watching: it must come through the fix completely untouched, with no reordering and no alignment change.

10. Before & After

The same Confluence page, same framing, one fix apart. Look at the list markers: in the first image the numbers and bullets sit on the left of Arabic text; in the second they have moved to the right, where an Arabic reader expects them.

11. Limitations

Confluence Cloud constrains what any app can change. These are published rather than buried, because finding them after paying is worse for everyone.

12. Troubleshooting

13. Support

• Email support@contextra-labs.com — questions, bug reports and feature requests all go to the same place.
• Support page — response times and what to include in a report.
• Atlassian Marketplace listing ↗
• Privacy policy · Terms & EULA

When reporting a problem with a specific page, the most useful details are the space key, whether the fix was manual or automatic, and what the panel said.