Confluence OneDrive Integration: The Complete 2026 Guide

Documentation lives in Confluence. The actual working files, the spreadsheets, specs, and slide decks people are editing all day, live in OneDrive. That split is normal, but it also means anyone who wants the full picture has to leave one tool to check the other, or worse, starts copying files into Confluence just to keep things in one place. Within a few months, nobody's sure which copy is current.

This guide covers every practical way to connect Confluence and Microsoft OneDrive in 2026: the native option built into Confluence itself, the Marketplace apps that go further, and the automation platforms that connect the two behind the scenes. It also covers what actually happens when a team fixes this properly, using a real, named customer's numbers rather than a marketing estimate.

Key takeaways:

• Confluence-OneDrive integration means embedding, previewing, or editing OneDrive files inside Confluence pages without manually uploading or downloading anything. It's not a migration, OneDrive stays the source of truth.
• There are three real paths: Smart Links (native, free, view-only), Marketplace apps (embedding plus in-place editing and permissions), and automation platforms like Zapier (for triggered workflows, not daily browsing).
• Most Marketplace apps and automation platforms are built around Microsoft 365 work or school accounts with OneDrive for Business, personal consumer OneDrive typically isn't supported. ikuTeam's SharePoint Connector for Confluence is a genuine exception: it connects SharePoint, OneDrive for Business, and personal OneDrive, all through the same app.
• Atlassian's native OneDrive macro is gone. It was deprecated from the new Confluence editor back in February 2022 in favor of Smart Links, and fully retired from the legacy editor on May 30, 2024.
• ikuTeam's SharePoint Connector for Confluence is also one of the few Marketplace apps that supports real-time Microsoft 365 co-editing, not just embedding a preview.

What Is Confluence-OneDrive Integration?

Confluence is Atlassian's knowledge-management platform, where teams write, organize, and search documentation across pages and spaces. OneDrive for Business is Microsoft 365's cloud storage layer, built for storing, sharing, and co-editing Office files. Integrating the two means a Word document, Excel sheet, or PowerPoint deck stored in OneDrive can be embedded, previewed, or edited from inside a Confluence page, with OneDrive still holding the actual file. Nothing gets duplicated into Confluence, and there's no manual upload or download step standing between the two tools.

Most integration paths need a Microsoft 365 work or school account with OneDrive for Business. ikuTeam's SharePoint Connector for Confluence, covered in detail below, is a genuine exception: it also connects personal OneDrive accounts (the kind tied to an Outlook.com or Live.com address) through the same app. It's a secondary use case rather than the main one, and it works reliably as long as an organization's Microsoft 365 admin hasn't specifically blocked personal Microsoft account connections at the tenant level. If a personal OneDrive connection ever fails, that's usually a policy to check on the Microsoft side, not a limitation of the app itself. If you're evaluating a different tool for this, confirm which Microsoft account types it actually supports before assuming a personal OneDrive account will work with it.

One naming note worth clearing up early: SharePoint, OneDrive for Business, and personal OneDrive are close enough under the hood that ikuTeam's connector app treats all three as options in the same folder picker, rather than requiring separate setups. SharePoint is built around team-site document libraries; OneDrive for Business and personal OneDrive are both built around individual storage, one enterprise-managed, one not. In practice, you'll usually pick whichever one already holds your team's files rather than choosing between them conceptually.

If your team is specifically organized around SharePoint sites and libraries rather than individual OneDrive storage, our Confluence SharePoint Integration guide covers that side in more depth.

Three Ways to Connect Confluence and OneDrive

Smart Links (native, free). Paste a OneDrive share link into a Confluence page, and it unfurls automatically into a preview card, no macro, no setup. This has been the default path since Atlassian deprecated the old OneDrive macro from Confluence's new editor in February 2022. The legacy editor held on a bit longer: Atlassian didn't fully retire the macro there until May 30, 2024, after which any existing macro instances just display a message prompting a conversion to Smart Links. Smart Links are genuinely useful for the occasional linked file, but they're view-only. There's no folder browsing, no in-place editing, and no way to sync permissions between the two systems.

Confluence also has a separate native feature worth knowing about, though it solves a different problem: importing a Word document straight from OneDrive into a brand new, fully editable Confluence page. From Create, then More actions, then Templates and import, you can choose OneDrive as the source and pull in a .docx file (up to 100 MB) as its own page. This isn't a live sync. The resulting page becomes a one-time copy that Confluence now owns outright, and any shapes in the original document get replaced with placeholders. Reach for this when you want to turn a document into native Confluence content permanently, not keep it live and editable in OneDrive.

Marketplace apps. This is where actual file management happens: browsing folders, previewing a wider range of formats, editing Office documents without leaving Confluence, and controlling who can see or edit what. Several apps on the Atlassian Marketplace handle OneDrive and SharePoint embedding at varying depths. The rest of this guide walks through one of them, ikuTeam's SharePoint Connector for Confluence, in enough detail that you can judge whether the approach fits your team, whichever app you end up choosing.

Automation platforms. Zapier and Microsoft Power Automate can connect Confluence and OneDrive behind the scenes, for example, creating a new Confluence page whenever a file lands in a OneDrive folder. Zapier actually supports this: it has a published template for creating Confluence pages or blog posts from new OneDrive files. Power Automate is more limited than it looks. Microsoft's own official Confluence connector for Power Automate is read-only, it can fetch pages, page content, and spaces, but it has no action to create or update a Confluence page. Building that specific automation requires a custom connector that calls Confluence's REST API directly, not the standard Power Automate connector. Worth knowing before you build a workflow around an assumption that turns out to be wrong.

These three approaches aren't mutually exclusive. A common pattern: Smart Links for the occasional one-off reference, a Marketplace app for the folders your team lives in daily, and an automation platform for the handful of workflows that should happen without anyone clicking anything.

Confluence, Microsoft Teams, and OneDrive Together

Many teams running OneDrive also live inside Microsoft Teams for daily communication, and Atlassian has a separate official integration for that pairing: Confluence Cloud for Microsoft Teams. It adds a Confluence page as a tab inside any Teams channel, so people can view, edit, and comment on it without leaving Teams. Meeting notes taken during a Teams call can publish straight to Confluence with action items already organized, and there's a dedicated Confluence notes panel inside the Teams meeting window itself for creating and publishing content on the spot.

It also connects to Microsoft 365 Copilot: inside a Teams chat, asking Copilot to fetch Confluence pages updated by a specific person actually retrieves and displays that real Confluence content, since the official app exposes it to Copilot within the Teams experience.

There's a third angle worth knowing about, and this one runs through ikuTeam's own connector rather than Atlassian's official Teams app. Every Microsoft Teams channel has a SharePoint folder behind it, holding whatever files get shared in that channel's chat. The SharePoint Connector for Confluence, and ikuTeam Files for Confluence, which adds Google Drive, Box, Dropbox, and Egnyte on top, can connect that specific folder the same way they'd connect any other SharePoint folder. That makes everything shared inside a Teams channel browsable and attachable inside a Confluence Space too, either dropped onto specific pages or just browsed from the connected folder list.

Between the three, that's a different integration from the OneDrive file connector covered in the rest of this guide. Atlassian's official app connects Teams conversations to Confluence pages, Microsoft's Copilot layer surfaces Confluence content inside Teams, and ikuTeam's connectors bring a Teams channel's own files into Confluence directly. Most organizations running the full Microsoft 365 and Atlassian stack together end up using more than one of these at once.

Setting Up the SharePoint Connector for Confluence (Step by Step)

Install ikuTeam’s SharePoint Connector for Confluence app from the Atlassian Marketplace, then open it from the link in Confluence's sidebar. It's ready to use immediately, no account creation required beyond connecting a folder.

1. Click the "Connect folder" button.
2. Choose where the folder lives, SharePoint or OneDrive for Business, and authenticate. Signing in triggers Microsoft's own OAuth 2.0 flow: you approve access, and the app receives an authorization token rather than your password. Credentials are never stored, and you can revoke the authorization at any time from Microsoft's side.
3. Navigate to the site or folder you want to share with your team.
4. Select the folder using the checkbox (you can select more than one at once).
5. Optionally set permissions on the "Permissions" tab. By default, everyone with access to the Confluence space can view and edit the connected folder.
6. Click "Connect."

That's the whole setup. From here, the folder is browsable from Confluence's sidebar and from the /attach (or /sharepoint, /onedrive) macro on any page.

One behavior worth understanding before you rely on this daily: the connected storage location is the actual source of truth. Edit a file in Confluence, and the change appears everywhere the file is shared or embedded. Delete the file from OneDrive or SharePoint directly, and it disappears from Confluence too. Edit it from a desktop Office app, and Confluence reflects that as well. That's the point, one file, one version, no finalv2 copies scattered across two systems, but it does mean deleting the source file is not something to do casually.

Working With Connected Files Day to Day

Once a folder is connected, the file manager handles browsing, previewing, editing, uploading, and organizing.

Previewing covers a wide range of formats: images (GIF, JPG, PNG), PDFs including password-protected ones, the full range of Microsoft Office formats and templates, Rich Text files, and video (MP4, MOV, and WEBM). Visio files preview too, but only when an admin has turned on the "Replicate storage permissions" setting covered in the next section.

Editing works for a slightly narrower set: Word, Excel, and PowerPoint documents and templates, plus OpenOffice formats. Clicking Edit opens the relevant Microsoft 365 editor in a new tab, ready in seconds. Microsoft Office formats support real-time collaboration, multiple people editing the same file at once with no lockouts, and autosave means there's no explicit save step, just close the tab when you're done. OpenOffice files use the same Microsoft 365 editor but don't support that real-time collaboration piece.

Uploading works by drag-and-drop into an open folder, or through the upload button and file picker. You can also create new Word, Excel, or PowerPoint documents directly from Confluence, they land in the connected folder immediately, ready for real-time editing from the start.

Attaching a file or folder to a page uses the same macro either way, triggered by typing /attach (or /document, /file, /folder, /sharepoint, /onedrive) or through the "Insert items" menu. Once inserted, you can control how much space it takes up on the page: a compact or regular header, and a collapsed or automatically expanded preview.

Permissions and Governance

This is where a lot of evaluation conversations actually happen, and it's worth understanding before rolling this out past a single team.

The app offers three permission levels per connected folder: anyone with space access can view and edit (the default), editing restricted to the folder owner with the option to grant specific people, groups, or roles view or edit access, or viewing and editing restricted entirely to the owner and whoever they explicitly add. Permissions are additive, if someone has individual view access but also belongs to a group with edit access, they get edit access.

Here's the detail worth flagging clearly: by default, this permission model overrides the actual permissions set in SharePoint or OneDrive. It's built for ease of use, not to duplicate Microsoft's access rules folder by folder. If your organization needs Confluence access to genuinely respect SharePoint or OneDrive's own permissions rather than the app's simplified model, an admin can turn on "Replicate storage permissions." That requires each user to authenticate individually to a connected folder, and it's what unlocks Visio preview support as well. It's a real tradeoff: simpler default sharing versus authentication that mirrors the source system exactly, and the right choice depends on how sensitive the content in question actually is.

The Real Cost of Not Integrating (and What FINEOS Solved)

The productivity argument for this isn't abstract. Gloria Mark's research at UC Irvine, from a 2004 study that shadowed 36 professionals for three days and timed every interruption, found that people took an average of 23 minutes and 15 seconds to fully resume a task after being interrupted. Leaving Confluence to go find a file in OneDrive, then finding your way back to what you were doing, is exactly that kind of interruption, repeated every time someone needs a document that isn't where they're already working.

FINEOS, a global insurance software vendor with over 1,200 employees and 25 years of accumulated SharePoint documentation, ran into this directly. Their Cloud Services Optimization team had rolled out Confluence as a modern knowledge hub, but decades of engineering documentation and CISO-mandated compliance records were required to stay inside SharePoint for security reasons. Every reference to a compliance protocol or technical spec meant leaving Confluence, finding the file in SharePoint, and finding a way back.

FINEOS evaluated multiple Marketplace apps before choosing ikuTeam's SharePoint Connector for Confluence. In their own words: "When we implemented Confluence as an organization, we looked at all of the plugins on the market and ikuTeam was the only one that solved that problem for us, which was really helpful," said Alyssa Bowers, Technical Advisor on the Cloud Services Optimization team. Internally, FINEOS estimated the context-switching cost at around 20 minutes of lost focus time per day and targeted a roughly 4% direct gain in engineering capacity by keeping SharePoint content accessible and editable directly inside Confluence, without duplicating it or requiring a migration.

There's a second layer to the story worth including: FINEOS also uses the connector to feed Atlassian's Rovo AI assistant. Because the connector links specific SharePoint files to the specific Confluence pages and spaces they're embedded in, Rovo can summarize that legacy documentation in context, rather than just treating it as one more file in a generic enterprise-wide index. Read the full FINEOS case study for the complete story, including the compliance evaluation criteria FINEOS used and more from Bowers on working with ikuTeam directly.

Common Gotchas and Troubleshooting

A few real friction points worth knowing before they surprise you:

Personal OneDrive isn't supported. If your team's files live in a free, consumer OneDrive account rather than OneDrive for Business, none of the Marketplace apps or automation platforms in this guide will connect to it properly.

Macros break across spaces. Copying or moving a Confluence page that contains a connector macro works fine within the same space. Move or copy it into a different space, though, and the macro breaks, because the folder it references was never connected to that new space in the first place.

Disconnecting isn't instantly permanent. If you disconnect a folder or an entire storage place by mistake, there's a 30-day window to reconnect it and restore the attachments. After that, restoring the previous attachments isn't possible.

Confluence's own search can already find some file content. Unlike Jira, which only searches issue fields and never looks inside attachments, Confluence at least attempts to extract and index text from supported attachment types, including Word and Excel files, alongside page content. In practice, reliability varies by format and file size, PDFs in particular are inconsistently indexed, according to repeated user reports in Atlassian's own community forums. It's not a reason to skip a proper OneDrive integration, but it's worth testing on your own content rather than assuming every attached document is fully searchable.

Frequently Asked Questions

What is Confluence OneDrive integration? It's connecting Confluence to Microsoft OneDrive, so files stored in OneDrive can be embedded, previewed, or edited directly inside Confluence pages, without uploading a duplicate copy. OneDrive remains the source of truth for the file.

How do I connect OneDrive to Confluence? Paste a OneDrive share link into a page for a quick, view-only Smart Link preview, or install a Marketplace app like the SharePoint Connector for Confluence by ikuTeam to browse folders and embed a live, editable file through the /attach macro. The Marketplace app route also covers SharePoint through the same folder picker, since both run on the same underlying storage connection.

What does Confluence integrate with? Beyond OneDrive and SharePoint, Confluence has official integrations with Microsoft Teams, Google Drive and Google Docs, and Jira, plus hundreds of Marketplace apps covering everything from diagramming to project tracking. This guide focuses specifically on the OneDrive and SharePoint side of that ecosystem.

Can Microsoft 365 Copilot access Confluence? Yes, through two separate, official mechanisms, neither of which is the OneDrive-to-Confluence direction covered in the rest of this guide. Microsoft publishes a Graph Connector for Confluence, with separate versions for Confluence Cloud and Confluence Data Center or Server, that indexes Confluence content so it surfaces inside Microsoft Search and Copilot across Teams, Outlook, and SharePoint, respecting each user's actual Confluence permissions. Separately, the official Confluence Cloud for Microsoft Teams app lets Copilot fetch specific Confluence pages from inside a Teams chat. Both move Confluence content into Microsoft 365, the reverse of embedding OneDrive files in Confluence.

Can I connect a personal OneDrive account to Confluence? Generally, no. Integration paths, from Marketplace apps to automation platforms, are built around OneDrive for Business and Microsoft 365 work or school accounts, which carry the admin consent and permission model these tools rely on. Free consumer OneDrive accounts typically don't support this.

Does Confluence support real-time co-editing of OneDrive files? Not natively through Smart Links, those are view-only previews. Marketplace apps like ikuTeam's SharePoint Connector for Confluence do support real-time co-editing of Word, Excel, and PowerPoint files through the Microsoft 365 editor, with autosave and no file locking.

What happened to the native OneDrive macro in Confluence? Atlassian deprecated it. Smart Links became the default in the new Confluence editor back in February 2022, and the macro was fully retired from the legacy editor on May 30, 2024. Any old macro instances now prompt a conversion to Smart Links.

Can I automate Confluence and OneDrive with Zapier or Power Automate? Zapier, yes, it has a published template for creating Confluence pages from new OneDrive files. Power Automate is more limited: Microsoft's official Confluence connector only supports reading pages and spaces, not creating or updating them, so that specific direction requires a custom connector built against Confluence's REST API.

Do OneDrive permissions carry over to Confluence automatically? Not by default. Most Marketplace apps, including ikuTeam's, use their own simplified permission model unless an admin specifically enables a setting to require authentication that mirrors the source system's actual permissions.

Does Confluence Data Center support OneDrive integration? It depends on the app. ikuTeam's SharePoint Connector for Confluence supports Confluence Cloud as well as Data Center versions 10.0.1 through 10.2.14.

What happens if I disconnect a OneDrive folder by mistake? You have 30 days to reconnect it and restore the attachments that depended on it. After that window closes, the previous attachments can't be restored.

Keeping documentation in Confluence and working files in OneDrive shouldn't mean choosing between the two. See the SharePoint Connector for Confluence on the Atlassian Marketplace, or book a demo to see it connected to a real OneDrive account.