Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: changed add-on to app and a few other minor changes

...

Finding and managing images for a site can be difficult. This site uses the Attachment Table macro, which is part of the Advanced Tables for Confluence add-on app, to help. It provides a good inventory view and makes finding and removing obsolete images easier. We follow a process where all site wide sitewide (global) images are to be attached to the Images page. These are images that are most likely to be needed on multiple pages or are of a general nature like banners, icons, and other standard image assets. Page specific attachments are often just attached to their respective pages. Sometimes one of these images needs to be used on other pages, in this case, the image should be moved to the global Images page. Duplication should be avoided - ; specifically, be careful when copying pages with attachments as it duplicates the attachments (sad)attachments

The Attachment Table macro can also be used to manage general attachments, but this how to focuses focus on images specifically.

The following describes what is done on this site. You will need to adjust based on your own requirements and size of your site. In our case, we split management of the images into 2 cases - global images and everything else. Larger sites may want to manage it on a space level by constructing a template page and copying it to each space.

...

Table plus
highlightColor #ffffec
rowStylesbackground:#f0f0f0;color:#222;font-size:14px;border-bottom:black 2px solid;border-top:black 2px solid;,
stylebackground-color:white;
autoNumbertrue
enableSortingfalse


StepDescriptionExample
Edit the pageA page with image attachments to be managed.Images
Add the Attachment Table macroStart with the default - showing all attachments to the page with default columns.
Edit the attachment-table macro

Modify the parameters below as needed for your situation.


Set the Attachment Table settings > Data settings > Columns to display parameter to a comma separated list of available columns.

The Display Thumbnails example has more on this.

Thumbnail is important for images.

Location (or Properties) is important as it provides a link to manage the attachment

We used: File, Thumbnail, Size, Created, Creator, Location, Comment 

Optionally, set Attachment Table settings > Data settings > Date format parameter


We used: yyyy-MM-dd
Optionally, set Column settings > Numbering & Totaling > Insert auto number columnA row number is convenient for referencing.
Optionally, set Column settings >  Sorting > Automatically sort by this column and Automatically sort in descending order if applicableStarting from a specific order is useful.We used: Created column for sorting with descending selected


Steps for

...

Sitewide Images

These steps are for managing images across a selection of spaces and pages. Many are similar to the previous example. Some understanding of how to use regular expressions is assumed.

Tip
titleBe careful on larger sites

Gathering a large number of attachments from lots of pages can take significant time. Subset appropriate appropriately for your site. For testing, limit the pages or spaces accessed until you are happy with the result. For production use, consider using the Cache Macro (Confluence download only) to reduce resources and improve display time.

...