Easy Tech TutsHow to Create a Confluence Page in Jira
By Impran M NLast checked against official docs
When Jira and Confluence share the same Atlassian workspace, you don't have to leave a work item just to start writing documentation about it. A menu on the item itself opens a real Confluence editor, lets you build out a page, and hands you a Publish button when it's ready. This guide walks through that flow starting from an open work item, through the editor that appears, to publishing the finished page, and covers the option to link an existing page instead of creating a new one.
01Open the Jira work item you want to document
Click into the item; in this walkthrough, a task called "TEST work" (TPT-10), which opens its full view with Description, Subtasks, Linked work items, and an Activity section on the left, and a Details panel on the right showing Assignee, Reporter, Priority, and similar metadata. Whatever Confluence page you create next will end up tied back to this item.
02Create the page from the + menu
Near the top of the item is a + control labeled "Add or create related work." Open its dropdown, select Page, then Create page. This only works if your Jira and Confluence sites are part of the same Atlassian workspace; it's the built-in link between the two products, not a separate integration you install. The same dropdown also offers Live Doc, for a Confluence live document instead of a standard page, if that fits what you're documenting better.
03Work inside the Confluence editor that opens
A panel appears with a full rich-text toolbar, text styles, formatting, tables, emoji, and more, sitting above a live page draft. In this example the page is titled "JIRA TASKS - Confluence," attributed to the same user who owns the Jira item, giving you a real editor rather than a stripped-down preview.
04Add structured content, not just text
The editor supports more than paragraphs. The draft shown here has an embedded database block titled "Untitled database 2026-07-01" inserted directly into the page, with a confirmation toast noting "Database added under this content" and an option to open it in a new tab for easier editing. Worth knowing if your documentation needs more structure than plain notes, such as a table of related decisions or test cases alongside the issue.
05Write the documentation and publish
Fill in whatever the issue actually needs recorded: meeting notes, a spec, acceptance criteria, or a summary of a decision made in the comments. Give the page a clear title people can find later, not just a name that only makes sense next to the Jira item it started from.
When it's ready, click Publish in the top right of the editor. The page then exists as a normal Confluence page in whatever space it was created under, and a link to it appears under Confluence Content on the Jira work item, so anyone opening the issue later can find it without searching Confluence separately.
When it doesn't work
A teammate can open the Jira item but not the linked Confluence page
Why: A newly published page inherits the permissions of its Confluence space, which can be more restrictive than the Jira project it's linked from.
Fix: Check the space's access settings rather than recreating the page; this is a permissions issue, not a broken link.
You want to attach a page that already exists instead of making a new one
Why: The + menu's default path, Page then Create page, always generates a brand-new page.
Fix: Use the same dropdown and choose Page, then Link page, to connect the work item to an existing Confluence page instead.
There's no Page option under the + (Add or create related work) menu
Why: The Jira and Confluence sites aren't part of the same Atlassian workspace, so the create-content link between them isn't available.
Fix: Ask a site admin to confirm both products are on the same Atlassian organization before trying again.
Frequently asked questions
Do Jira and Confluence need to be connected first?
Yes. This only works when your Jira and Confluence sites are part of the same Atlassian workspace, which is what makes the Page option available under the + Add or create related work menu on a work item.
Can I link an existing Confluence page instead of creating a new one?
Yes. From the same + menu, choose Page, then Link page, rather than Create page, to connect the work item to a page that already exists.
Can I add more than text to the Confluence page?
Yes. The editor supports rich formatting and structured content blocks; the example here embeds a database block directly into the page, not just plain paragraphs.
Will changes to the Jira issue update the linked Confluence page?
No. The two stay linked for reference, but content on each is independent; editing the Jira item afterward won't change anything already published on the Confluence page.
Who can see the newly created Confluence page?
Visibility depends on the permissions of the Confluence space the page is published into, which can be more restrictive than the Jira project; check space access if a teammate can't open it.
Sources and last check
Click path and screens come from a walkthrough recorded in July 2025. The control's exact name, the + (Add or create related work) menu, and the Page > Link page alternative to creating a new page were checked against Atlassian's official Confluence Cloud support documentation in September 2026, which describes that button and the Link page option directly. The requirement that both sites share a workspace, and the space-permission caveat now in troubleshooting, were already stated in the original walkthrough and were not independently re-confirmed against a separate docs page.
About the author
Impran M N
I've been hooked on technology for as long as I can remember — especially the new tools and AI apps that seem to land every other week. Easy Tech Tuts is where I write up whatever I've just worked out: I do the task in the real product, record the screen, and turn it into the guide I wish I'd found first.
