Table Filter is one of the three macros bundled in Table Filter for Confluence add-on. This macro allows you to filter your table data with the following filter types:

  • Drop-down filter fetches all the unique values from the selected table column and allows you to select one or multiple values to filter your table by.
  • Free text filter allows you to enter custom text query to filter data in the selected column. This filter support regular expression so you can enter custom text queries for flexible data filtration.
  • Global filter works the same way as free text filter but it filters data throughout the whole table.
  • Number range filter allows you to specify the number ranges for filtering data values within the pre-defined range.
  • Date filter allows you to select the time period for showing data values.
  • Icon filter allows you to select the appropriate icons, emoticons or images for table filtration.

See the next pages for the details on how to work with the macro:

Inserting Table Filter macro on the page

There exist three ways to insert the Table Filter macro on the page.

Macro InsertionInstructionsSupported Data
 Inserting the macro through the action icon on the editor pane
  1. Switch Confluence page to the edit mode.
  2. Position the mouse pointer within the table.
  3. On the editor pane, click the Filter table data icon.

This feature is available in Confluence Server only.

  1.  Manually created and copied tables
Manual entry of the {Table Filter} query on the page
  1. Switch Confluence page to the edit mode.
  2. Position the mouse pointer in the appropriate place on the page.
  3. Start entering {Table Filter}.
  4. From the prompted list of macro choices, select Table Filter.

 

  1. Manually created and copied tables
  2. Macros outputting table data
Selection of the Table Filter macro in the Select Macro form
  1. Switch Confluence page to the edit mode.
  2. Position the mouse pointer in the appropriate place on the page.
  3. On the editor pane, click Insert.
  4. In the Select Macro form, locate the Table Filter macro and insert it on the page.
  5. Place the table within the macro.
    1. Manually created and copied tables
    2. Macros outputting table data

  1. Removing Table Filter macro for Tables

  2. Switch Confluence page to the edit mode.
  3. Select the Table Filter macro with the table or macro outputting the table.
  4. Click Unwrap.