Can you lock a file in Confluence?

By Jake Marsh · Updated

Confluence Cloud has no way to lock an attachment, and no app can add a true lock, because Confluence saves every upload before an app hears about it. What you can do with Dibs is check the file out: click Dibs: check out files in the page byline, tick the file, add a reason and an expiry, and click Check out. Everyone who opens the page sees a banner saying you have it, and if someone uploads over it anyway, Dibs tells you both and, in Restore mode, makes your version the newest one again.

Why Confluence can't lock attachments

Atlassian's request for attachment locking, CONFCLOUD-2841, and the related check-in/check-out request, CONFCLOUD-4462, are both marked Gathering Interest. Page restrictions control who can edit a page and its files at all, but they can't say "only one person at a time" for a single file, and changing restrictions every time someone edits a spreadsheet isn't practical.

For apps, every attachment event (an upload, a new version, a trash) arrives after the change is saved. So Dibs is built to warn, record and react rather than block.

Steps to check out a file

  1. Open the page that holds the attachment.
  2. Click Dibs: check out files in the byline under the page title. You need edit permission on the page.
  3. Tick the file, or several. Select all takes every attachment on the page, up to 100 at a time.
  4. Add a reason so people know what you're doing, for example "Updating Q4 totals" or "Legal review, back Friday".
  5. Pick an expiry. The choices go up to the space's maximum, 14 days by default.
  6. Tick Check in: release when I upload a new version if you want your next upload to release it for you.
  7. Click Check out. The banner appears at the top of the page for everyone.

What other people see and can do

Someone else wants toWhat happens
Open the pageThe banner lists the file, who has it, the reason and the expiry
Know when it's freeThey click Tell me when free and are mentioned in a page comment when it's released or expires
Upload a new version anywayIt is saved, then Dibs logs it, mentions both people in a page comment and, in Restore mode, uploads the holder's version again as the newest
Move the file to the trashIt's logged and announced; a space admin can restore it from the space trash

Choosing how strict a space is

A space admin sets the mode in Space settings > Integrations > Dibs:

  • Restore (the default): another person's upload is undone by putting the holder's version back on top. Their upload stays in the version history.
  • Record: the new upload stays current, and both people are told.
  • Off: nobody can check out files in that space.

The same screen sets the default and longest expiry, whether check-outs with no expiry are allowed, and whether Dibs posts page comments.

Releasing the file

When you're done, upload your new version (it releases the file if you ticked the check-in option) or click Release in the dialog. Apps > My checked-out files shows everything you hold across the site, with Release all. A space admin or Confluence admin can release anyone's check-out, for example when someone is away.

Dibs starts with Atlassian's 30-day free trial; prices are on the Dibs page.

What it costs

Dibs is From $21.50 a month for up to 10 users. Every plan and the install link are on the Dibs page.

Dibs: Attachment Check-out for Confluence

Check out Confluence attachments before you edit them. See who has each file, get told on overwrites, restore the right version. From $21.50 a month for up to 10 users.


Questions

Does checking out a file stop someone downloading it?

No. Anyone who can see the page can still open and download the file. The banner tells them it's being edited.

Can I lock a whole page of files at once?

Yes. Select all ticks every attachment on the page, up to 100, and they share one reason and expiry.

How fast does Dibs react to an overwrite?

Usually within seconds of the upload, occasionally a few minutes, depending on when Confluence sends the event.

Does it work on Confluence Data Center?

Dibs is for Confluence Cloud only.


More Dibs guides


More Confluence guides