Using Regex Expressions To Select Attachments

On this page

Overview

This page demonstrates how to use the Attachment Table macro, which is part of the Advanced Tables for Confluence add-on, to select attachments based on the Space or attachment name, using a Regex expression.

  • Use the special @self value for the spaceRegex parameter to match on all attachments in the current Space.
  • Use .*png|.*jpg to match on attachments whose name ends in png or jpg.

Macro Browser Input

Select this Macro

Macro NameAttachment table
Macro Syntax{attachment-table}

Define these Parameters/Values

Space key or space name regex @self
Attachment name regex.*png|.*jpg

Screenshot

 

 

Wiki Markup Input

{attachment-table:spaceRegex=@self|attachmentRegex=.*png} 

Confluence is more limited on parameter values. In this case, | (pipe - used for regex or) is a reserved character, so it cannot be used.

 

Example Result

Selecting attachments based on matching on more than one label

The above example shows how to match on one label. Constructing a regex to match attachments that have 2 or more specific labels is a bit more complicated.

  1. Set the Label match option to all
  2. Use a regex pattern similar to the following using xxx, yyy, and zzz as example labels:
2 labels:  .*(?:.*\b(?:(?:xxx)|(?:yyy))\b.*){2}.*
3 labels:  .*(?:.*\b(?:(?:xxx)|(?:yyy)|(?:zzz))\b.*){3}.*

 

Other Examples

Visit our full list of product examples for additional inspiration!