← Back

How to Add a Live Org Chart to Confluence (That Never Goes Stale)

By
Aruna Rao
Updated
April 27, 2025

Your team uses Confluence because you value dynamic information. Documentation is never frozen—anyone can update it when things change. Wikis reflect current reality. Information is collaborative, always current, a single source of truth.

But org charts? They’re usually static. A PNG or SVG someone drew in PowerPoint, last updated three months ago when someone remembered to export a new version. Every new hire gets old information. Onboarding docs contradict each other. Board members see outdated structure.

This is philosophically inconsistent. If your team trusts Confluence for dynamic, collaborative knowledge, why accept static org charts? Org charts should follow the same principles: always current, reflecting reality as it changes.

This article shows how to embed a live org chart in Confluence that updates automatically, extending your dynamic documentation philosophy to organizational structure itself. (For deeper context on why this matters, see Why Org Charts Fail in Fast-Growing Companies.)

The Traditional Approach: Static Org Charts in Confluence

Here’s how most teams currently manage org charts in Confluence:

  1. Someone creates an org chart in PowerPoint, Lucidchart, or Visio and exports it as a PNG or SVG
  2. Upload it to Confluence - Add the image to an “Organization” page or employee directory
  3. When the org changes (new hire, promotion, restructure):
    • Someone notices the chart is outdated
    • They track down whoever owns the original file
    • Re-open the diagram, make edits, adjust layout
    • Export a new version
    • Upload the new image to replace the old one
    • Send a message to the team: “org chart updated!”
  4. Repeat - Every few months when enough changes accumulate

The friction points:

  • Ownership is unclear - Nobody explicitly owns keeping it current. It’s “someone’s” responsibility
  • Update lag - Changes are always several weeks behind reality. By the time the new chart is uploaded, three more people have joined
  • Version chaos - Multiple versions exist (old PowerPoint file, Lucidchart draft, exported PNG, embedded in Confluence). Which is current?
  • Breaks collaboration - Unlike wikis where anyone can fix outdated info, org chart updates require finding the original file and the person who created it
  • Creates contradictions - Your documentation says you have a “Product team,” but the org chart shows that structure from two months ago

This approach treats org charts as documents rather than living information—which contradicts how your team actually works in Confluence.

The Better Way: Live Org Charts in Confluence

Pre-requisite: OrgNice Org Chart

Your OrgNice Project should be setup with your Google Sheets Organizational data. The Office Org Chart If you have your Google Sheet file but haven’t created an OrgNice Org Chart for it then you should start here.

Adding to Confluence

OrgNice Organizational Charts can be made available wherever they are needed - whether it is a website or your internal wiki like Confluence in just a few steps.

Share your Org Chart

To enable visitors of your Confluence page to view your Org Chart you will have to share it with them. You can either share your OrgNice Organization Chart to all members of your organization or with specific people. Access will be available only after logging in. If you don’t want that, you can share the chart publicly. Read more about sharing. If you are the only viewer of the page, then sharing is not required.

Insert Iframe into Confluence Page

  • Edit the Confluence page in which you want to add OrgNice
  • From the toolbar pick Insert Elements (the + icon at the right end of the toolbar) and type iframe in the search box Insert Iframe
  • You will see an IFrame added to your page with an IFrame editor that looks like this Iframe

Configure Iframe

We are now going to configure the Iframe to be able to show your Org Chart.

  • Head over to OrgNice, open your project and click on Sharing in the left menu and copy the URL in the Embed Chart section by clicking on the Copy button. You have to copy the URL and not the Iframe code. Sharing Copy
  • In the Confluence iFrame editor set the following values to these fields -
    • URL: Paste the value you just copied. It should look something like this (but with your project’s id in the url) - https://org-nice.com/app/project/d4070a67-fa24-41f2-8001-18000669bc38/chart.html?embed=true
    • Title: Provide a title
    • Width: 100%
    • Height: Provide a height that looks right to you for your chart. Try 800px. This stands for 800 pixels tall. You can experiment with the numerical value to adjust the height. You want the height large enough to be able to navigate the chart when it is reasonably expanded.
    • You can experiment with the rest of the fields - they modify various visual aspects of how the embedded content looks.
  • Save your page!
  • You can also set the page to Make full-width (option above the page title) to make the page and the chart wider (if you chose 100% for the width)

That’s it - you have embedded your OrgNice Organizational Chart into Confluence. OrgNice-Confluence

Enhance Your Org Chart with Confluence Data

Most teams already store valuable organizational data in Confluence—employee spaces, team wikis, profile pictures. You can enrich your org chart by pulling this existing data.

Individual team members often have personal Confluence spaces where they document their work, responsibilities, and contact info. Turn your org chart into a navigation hub:

  1. Add a “Confluence Space” column to your Google Sheet with each person’s Confluence space URL

    • Example: https://your-company.atlassian.net/wiki/spaces/ESMITH/overview for individual pages
  2. In OrgNice, configure this column as a Link typed field

    • Go to your project settings → Additional Fields
    • Add the Confluence Space column as a Link type
  3. Result: A clickable link appears on each person’s card. Team members can click it to jump directly to that person’s Confluence space

Beyond individual spaces, you can link entire departments or teams to their Confluence team spaces:

  1. Add a “Team Space” column to your Google Sheet and populate it for all members of a department with that department’s team space URL

    • Example: All Engineering team members link to https://your-company.atlassian.net/wiki/spaces/ENGINEERING/overview
  2. Configure as a Link field in OrgNice

  3. Result: Team members can navigate from individual org chart nodes to the broader team documentation and roadmaps

This transforms your org chart from a static diagram into a dynamic navigation and discovery tool—people explore organizational structure and immediately access individual profiles, team documentation, and department resources, all within Confluence.

Troubleshooting Common Issues

Issue: “Iframe Not Loading” or Blank Embed

Symptoms: The embedded iframe appears blank or shows no content Solutions:

  • Verify the sharing settings on your OrgNice project—make sure it’s set to “Shared with Organization” or “Public” if viewers need access
  • Check that you copied the full URL from the Embed section (not the iframe code)
  • Ensure the URL includes embed=true parameter at the end
  • Clear your browser cache and refresh the Confluence page

Issue: “Login Screen Appears Inside Iframe”

Symptoms: Instead of the org chart, visitors see an OrgNice login screen Cause: The chart isn’t properly shared, or the viewer doesn’t have access permissions Solutions:

  • Go to OrgNice → Sharing and set access level to at least “Specific Individuals” (or “Public” if intended for external sharing)
  • Add the email addresses of people who need to access the embedded chart
  • For organization-wide sharing, use the “Organization” option if you have it enabled

Issue: Chart is Too Wide or Gets Cut Off

Symptoms: The org chart is cramped, horizontal scrolling is hard, or parts are hidden Solutions:

  • Enable full-width page in Confluence: Above the page title, click the three-dot menu and select “Make full-width”
  • Adjust iframe width to 100% to fill the available space
  • Increase height if the chart needs more vertical space—try 1000px or higher depending on your org structure
  • Collapse/expand nodes in the live chart (if your org is very large) to navigate specific sections

Issue: Chart Doesn’t Update When Data Changes

Symptoms: You updated your Google Sheet or OrgNice project, but the embedded chart still shows old data Solutions:

  • Hard refresh the Confluence page: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
  • Verify that your OrgNice project is still connected to the correct Google Sheet
  • OrgNice updates typically reflect within 1-5 minutes—wait a few minutes then refresh
  • If updates still don’t appear, check OrgNice project settings to ensure auto-sync is enabled

Confluence Cloud vs Data Center

OrgNice embeds work on both versions, but there are some practical differences:

Confluence Cloud (hosted by Atlassian):

  • Easiest setup—no infrastructure management
  • iframe embedding works as described above
  • Good for small-to-medium teams
  • Limited customization options

Confluence Data Center (self-hosted):

  • More control and customization options
  • May require allowlisting org-nice.com domain if your security policies are strict
  • Work with your IT/security team to ensure external iframe sources are permitted
  • Same embedding steps apply, but may require additional firewall/proxy configuration

For most teams, Confluence Cloud with OrgNice is the simplest path to live, always-current org charts.

Why Live Org Charts Matter in Confluence

Static org charts in Confluence go stale the moment someone new joins or leaves. By the time you remember to update the image, three more people have changed roles. A live org chart solves this by always showing current structure—making Confluence a genuine source of truth for organizational information instead of a place where outdated docs create confusion.

This is especially valuable during:

  • Onboarding - New hires see current structure immediately
  • Reorganizations - Changes are reflected instantly across all documentation
  • Board/investor updates - No scramble to update org charts before presentations
  • Multiple teams/locations - Everyone accesses the same current structure

Learn Mode About OrgNice

Ready to build your own automated org chart? Try OrgNice with your Google Sheets today — it takes just a few clicks and keeps your charts always current. Learn More

← Back