Showing results for 
Search instead for 
Did you mean: 
Sign up Log in
It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

How to 'hide' attachments from being displayed when using the Attachments macro?


I need to 'hide' individual attachments from being displayed when using the Attachments macro, by placing a LABEL on each attachment that I don't want displayed.  

Does the Attachments macro support this capability (such as using a '-' in front of the label's name to exclude that attachment from being displayed)?

Is there an alternate means to do this, other than Labels?

1 answer

0 votes

Hello there, @Hal West !

We can actually to the direct opposite of what you described. We can set the Attachments Macro to display only the attachments that contain a specific label.

Here is how:


  1. Create a new page
  2. Insert the Attachments Macro
    1. PageEditAttachments.jpg
  3. Go into the macro settings
    1. AttachmentsMacroSettings.jpg
  4. Scroll the fields in the left side until you can see “Attachment labels”
  5. There, we will need to define all the labels that can be shown
  6. Save the settings
  7. Publish page
  8. Go to to the page attachments (three dots menu in the top right corner > Attachments)
    1. PageViewAttachments.jpg
  9. Define the same label that you defined within the macro to all the attachments you need to display
  10. Go back to the page view
  11. Check that your attachments are now displaying


The objective of hiding specific attachments can be achieved. However, instead of defining which labels can not be shown, we select those that can be shown.

Hopes this helps you, Hal!


[Confluence Server] Attachments Macro

Hi Diego,

Thanks for your answer.  It seems to describe standard and well-known functionality of the Attachments macro.   However, your answer does not meet our need.  

In our case, multiple parties will be attaching files to multiple pages 'without applying labels', and these files will be made visible on a single page containing the Attachments macro.  As leadership approves each attached file, they will apply a 'reviewed' label to the file and they want that file to 'drop off' of the list of files shown by the Attachments macro (though each file itself remains attached to its original page).   

Can the Attachments macro be made to 'remove' files from visibility which have certain labels?   If not, can Atlassian update the macro with this capability?   (we would want that!)


Dear Hal,

I hve exactely the same issue. Did you find a solution in the meanwhile?
Thanks for supporting.

Kind regards, 

Hello Diego, et al.

Can you please provide an answer or resolution to the above inquiry?   I have not yet received a complete answer.


Like # people like this
Diego Atlassian Team Aug 12, 2020

Hello there again @Hal West !

Thank you very much for explaining further. Now I believe that I completely understand your needs.

What we need is to display solely attachments that have no labels, correct? Currently, this is not possible with the Attachments macro.

This improvement has been listed here, for both Confluence Server and Cloud:

Since there is no preview of when or if this will be implemented, the best course of action is to vote and watch the report.

The possibility of filtering out specific labels has also been suggested a few years ago but was ultimately ruled out by Atlassian. You can check the request here:

Again, thanks for keeping the thread alive.

Hi Diego,

Thanks for the update.  I realize this is a 'feature request' - but a good one.  

I'm generally unhappy with Atlassian's lack of promptness to address certain 'bugs' and 'issues' in their tools, allowing them to exist for years, even if there haven't been hundreds of complaints. But this is a feature, not an issue.

I hope this feature request can be implemented soon, as it's a real need, sensible and logical, and the original creator of the Attachments macro probably should have included the capability to 'display' or to 'not display' attachments with any listed labels.

Best regards,

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Apps & Integrations

Send an Email or Publish to Confluence - What should you do with your release notes?

Background When you hear the words ‘Release notes’, almost always you think of an unsolicited email from a software vendor. But I am here to tell you that from our data, sending release notes via E...

130 views 1 2
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you