How to Add Attachment to Confluence Page

You’ve got a report, a design file, or a spreadsheet that your team needs — and it’s sitting on your desktop doing nothing. Sound familiar?

Confluence is one of the most widely used documentation and collaboration tools in the world, with over 10 million users across more than 60,000 organizations globally. Yet a surprising number of people still fumble when it comes to attaching files to a page. They either email the file separately, link to an outdated Google Drive folder, or just skip it entirely — leaving teammates scrambling.

This guide fixes that. Whether you’re uploading a PDF, an image, a spreadsheet, or a zip file, you’ll know exactly how to do it after reading this.

Why Attaching Files to Confluence Pages Matters

Before the how-to, let’s talk about the why — because understanding the value changes how you use the feature.

Teams that centralize documentation see measurable productivity gains. According to McKinsey, employees spend 1.8 hours per day searching for information — nearly 20% of the workweek. When files are attached directly to the relevant Confluence page, that search time collapses. Everything lives where it’s supposed to live.

A few reasons attachments make your pages more powerful:

• Context stays intact. A design brief attached to the project page makes far more sense than a file buried in email.
• Version control becomes easier. Confluence tracks attachment versions, so you always know what’s current.
• Collaboration improves. A Forrester Research study found that better-organized internal documentation reduces rework by up to 30%.
• Onboarding accelerates. New team members can find reference files immediately without digging through old threads.

The bottom line: attaching files isn’t just a housekeeping task. It’s a strategic decision that keeps work organized and teams aligned.

What File Types Can You Attach to Confluence?

Confluence supports a wide range of file types. Here’s what you can upload:

• Documents: PDF, DOCX, XLSX, PPTX, TXT, CSV
• Images: PNG, JPG, GIF, SVG, BMP
• Design files: Sketch, Figma exports, AI files (as downloadable attachments)
• Archives: ZIP, RAR
• Code files: HTML, XML, JSON, CSS, JS
• Video and audio: MP4, MOV, MP3 (note: large files may require admin-level upload permissions)

Important to know: The default maximum file size for Confluence Cloud attachments is 10 MB per file, though Confluence Data Center administrators can configure this limit. If you’re hitting a size wall, check with your admin or compress the file before uploading.

How to Add an Attachment to a Confluence Page

There are several ways to attach files. Here’s every method broken down clearly.

Method — Drag and Drop (Fastest)

This is the quickest way if you’re already editing a page.

Steps:

1. Open the Confluence page you want to edit
2. Click Edit (pencil icon) to enter editing mode
3. Open the folder containing your file on your computer
4. Drag the file directly onto the Confluence editor canvas
5. Drop it where you want it to appear on the page
6. The file will upload automatically and appear as either an inline preview (for images) or a download link (for documents)
7. Click Publish or Update to save your changes

Why this works well: No menus, no extra clicks. Ideal for images and PDFs that you want embedded visually in the page.

Method — Using the Insert Menu

If drag and drop isn’t working or you want more control over placement, use the insert menu.

Steps:

1. Open the page in Edit mode
2. Click where you want the attachment to appear
3. In the toolbar, click the “+” (Insert) button or use the keyboard shortcut / to open the insert panel
4. Type “Attachment” or “Files” in the search field
5. Click Files & Images
6. A dialog box will open — click Upload and select your file
7. Once uploaded, choose how you want it displayed (as a link, thumbnail, or preview)
8. Hit Publish

Pro tip: You can upload multiple files at once from this dialog by holding Ctrl (Windows) or Command (Mac) while selecting files.

Method — Attaching via the Page Options Menu (Without Editing)

You don’t always need to be in edit mode to upload files. This method lets you manage attachments separately.

Steps:

1. Navigate to the Confluence page
2. Click the “…” (More actions) button in the top-right corner of the page
3. Select Attachments from the dropdown menu
4. Click Upload file
5. Select one or multiple files from your computer
6. The files are now attached to the page and accessible from the Attachments panel

This method is useful when you want to make files available without embedding them into the page content. Anyone viewing the page can access them via the Attachments section.

Method — Embedding an Image Directly into Page Content

For images specifically, you can embed them inline so they display as part of the content — not just as a download link.

Steps:

1. Enter Edit mode on your Confluence page
2. Place your cursor where the image should appear
3. Press / and type Image in the panel
4. Choose Upload Image and select your file
5. Once uploaded, click the image in the editor to resize or align it
6. Publish the page

Supported image formats: JPG, PNG, GIF, BMP, and SVG. Confluence will render these inline so readers see the image without downloading anything.

Method — Attaching Files Using the Confluence Mobile App

For those working on mobile, Confluence’s app (available on iOS and Android) supports file attachment as well.

Steps:

1. Open the Confluence mobile app
2. Navigate to the page
3. Tap the Edit icon
4. Tap the “+” icon in the editor toolbar
5. Select File or Photo Library
6. Choose the file you want to attach
7. Tap Done and publish

Note: Mobile uploads are best suited for images and PDFs. Complex file types may display better when uploaded from desktop.

How to Manage Existing Attachments

Once files are uploaded, Confluence gives you tools to manage them without confusion.

Viewing All Attachments on a Page

Every Confluence page has an Attachments tab that shows all uploaded files in one place.

1. Click the “…” menu at the top right of the page
2. Select Attachments
3. You’ll see a list of every file attached, including file name, uploader, date, and version history

Updating or Replacing an Attachment (Version Control)

Instead of deleting and re-uploading, Confluence lets you update an attachment while keeping its version history — a critical feature for files that go through multiple revisions.

Steps:

1. Go to the Attachments panel (via the “…” menu)
2. Find the file you want to update
3. Click the “…” next to the file
4. Select Upload new version
5. Choose the updated file from your computer
6. Confluence keeps all previous versions, which you can view or restore at any time

According to Atlassian, organizations using Confluence’s version history feature reduce duplicate file confusion by a significant margin — especially in teams that work across time zones.

Deleting an Attachment

1. Open the Attachments panel
2. Find the file you want to remove
3. Click the “…” next to it
4. Select Delete
5. Confirm the deletion

Note: Deleting an attachment is permanent on most Confluence Cloud configurations. If your organization uses Confluence Data Center, admins may have recovery options through the trash.

Renaming an Attachment

Confluence doesn’t allow direct renaming of uploaded files in the standard UI. The workaround:

1. Download the file
2. Rename it on your computer
3. Upload it as a new attachment with the correct name
4. Delete the old version

This is a known limitation that Atlassian has been slow to address. For teams where file naming matters, establishing naming conventions before uploading is the smarter approach.

How to Link to an Attachment on Another Confluence Page

You may want to reference a file attached to one page while editing a different page. Confluence makes this possible with internal linking.

Steps:

1. In the editor, type / and select Link
2. In the search bar, type the name of the page that contains the attachment
3. Select the page, then choose the specific attachment from the list
4. The link will be inserted into your current page, pointing directly to the file

This is useful for shared resources — style guides, contracts, templates — that multiple pages need to reference without duplication.

Common Issues When Adding Attachments (and How to Fix Them)

File size too large

Compress the file before uploading, or ask your Confluence admin to increase the max upload limit. For Confluence Cloud, this is set at the organization level.

Unsupported file type

Confluence blocks certain file types for security reasons (executables like .EXE, .BAT). Convert to a supported format or package inside a ZIP file.

Upload fails repeatedly

Clear your browser cache, switch browsers, or try a different network. Slow connections cause timeouts during large file uploads.

Attachment not appearing after publish

Refresh the page. In some cases, Confluence requires a hard refresh (Ctrl + Shift + R or Cmd + Shift + R) to display newly uploaded attachments.

No permission to attach files

Contact your Confluence admin. Attachment permissions are set at the space level — if you can edit the page but not upload files, your space role may be set to “Viewer” or a custom restricted role.

Best Practices for Managing Attachments in Confluence

Name files clearly before uploading. File names like “Final_v3_REAL_THIS_ONE.pdf” are signs of a larger organizational problem. Use structured naming conventions: [ProjectName]_[DocumentType]_[Date].pdf.

Don’t use Confluence as a primary file storage system. It’s a documentation and collaboration tool, not a file server. For large media libraries or design assets, use a dedicated storage solution and link to it from Confluence.

Archive old versions instead of cluttering pages. Confluence’s version history means you don’t need multiple files named “v1,” “v2,” “v3.” One file, updated properly, tells the whole story.

Restrict sensitive attachments. If a page contains a confidential contract or HR document, set page-level restrictions so only authorized team members can view it. Confluence allows this through the Restrictions feature.

Audit attachments regularly. Outdated files on active pages create confusion. Set a reminder to review attachments quarterly — especially on high-traffic pages.

Confluence Attachment Statistics Worth Knowing

A few numbers that put all of this in context:

• Atlassian reports that Confluence has over 10 million active users across enterprise and SMB organizations worldwide
• Teams using centralized documentation platforms like Confluence report a 25% reduction in meeting time because context is already documented
• 87% of remote workers say they’ve lost productivity due to not being able to find the right file at the right time (Buffer, State of Remote Work)
• According to IDC, the average knowledge worker spends 2.5 hours per day searching for information — centralized file management in Confluence directly cuts into that number

Organizations using proper document version control report up to 40% fewer errors in deliverables due to using outdated files

Conclusion

Adding attachments to Confluence pages is one of those small habits that pays off in a big way over time. When files live alongside the context that explains them, teams move faster, make fewer mistakes, and spend less time hunting for information.

The five methods covered here — drag and drop, the insert menu, the attachments panel, direct image embedding, and mobile upload — cover every scenario you’ll encounter. Use version control to keep files clean, name them clearly before uploading, and audit your attachments regularly to prevent page clutter.

Confluence works best when it’s treated as a single source of truth. That starts with making sure every file your team needs is exactly where it should be.

Looking to grow your pipeline while your team focuses on execution? SalesSo builds end-to-end LinkedIn outbound systems — from precise targeting to scalable campaign design — delivering consistent results for B2B teams. Book a strategy meeting today.