--- title: "Managing Images on your Confluence site" canonical: "https://support.appfire.com/space/TBL/74814332/Managing%20Images%20on%20your%20Confluence%20site" format: markdown --- > Macro (div) > > ### On this page > > > Macro (toc) # Overview Finding and managing images for a site can be difficult. This site uses the [Attachment Table macro](https://appfire.atlassian.net/wiki/spaces/TBL/pages/74814506), which is part of the [Advanced Tables for Confluence](https://appfire.atlassian.net/wiki/spaces/TBL/overview) add-on, to help. It provides a good inventory view and makes finding and removing obsolete images easier. We follow a process where all site wide (global) images are to be attached to the [Images](https://appfire.atlassian.net/wiki/spaces/info/pages/86083606) 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](https://appfire.atlassian.net/wiki/spaces/info/pages/86083606) page. Duplication should be avoided - specifically be careful when copying pages with attachments as it duplicates the attachments 🙁.  The [Attachment Table macro](https://appfire.atlassian.net/wiki/spaces/TBL/pages/74814506) can also be used to manage general attachments, but this how to focuses 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. # Steps for a Page with Shared Images These steps assume you have a page that contains a set of shared images that need to be managed. > Macro (table-plus) > > | **Step** | **Description** | **Example** | > | --- | --- | --- | > | Edit the page | A page with image attachments to be managed. | [Images](https://appfire.atlassian.net/wiki/spaces/info/pages/86083606) | > | Add the [Attachment Table Macro](https://appfire.atlassian.net/wiki/spaces/TBL/pages/74814506) | Start 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 **Columns to show** parameter to a comma separated list of available [columns](https://appfire.atlassian.net/wiki/spaces/TBL/pages/74814506/Attachment+Table+Macro#AttachmentTableMacro-ColumnsAvailableForDisplay).
- The [Displaying Thumbnails example](https://appfire.atlassian.net/wiki/spaces/TBL/pages/74815070) 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 **Date format** parameter | | We used: **yyyy-MM-dd** | > | Optionally, set **Auto number on each row** | A row number is convenient for referencing. | | > | Optionally, set **Auto sort column** and **Sort descending** if applicable | Starting from a specific order is useful. | We used: **Created** column for sorting with **descending** selected | # Steps for Site-wide 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](https://appfire.atlassian.net/wiki/spaces/info/pages/86082100) is assumed. > ✅ **Be careful on larger sites** > ✅ > ✅ Gathering a large number of attachments from lots of pages can take significant time. Subset appropriate 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](https://appfire.atlassian.net/wiki/spaces/CACHE/pages/66586270) (Confluence download only) to reduce resources and improve display time. > Macro (table-plus) > > | **Step** | **Description** | **Example** | > | --- | --- | --- | > | Create a page | This is your management page for images. | [Site images](https://appfire.atlassian.net/wiki/spaces/info/pages/86081919) | > | Add the [Attachment Table macro](https://appfire.atlassian.net/wiki/spaces/TBL/pages/74814506) | Start 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 **Columns to show** parameter to a comma separated list of available [columns](https://appfire.atlassian.net/wiki/spaces/TBL/pages/74814506/Attachment+Table+Macro#AttachmentTableMacro-ColumnsAvailableForDisplay).
- The [Displaying Thumbnails example](https://appfire.atlassian.net/wiki/spaces/TBL/pages/74815070) has more on this. | **Page** is used here since we are searching across multiple spaces and pages**, **so having a link to the page is convenient.
**Thumbnail** is important for images.
**Location** (or **Properties**) is important as it provides a **link to manage the attachment** | We used: **spacename,Page,File, Thumbnail, Size, Created, Creator, Location, Comment** | > | Set optional parameters similar to the previous **Steps** section | | We used the same settings as the earlier example. | > | Optionally, specify **Space key or space name regex** | Use this to select the spaces to be included. Leave blank for only covering the current space. Use **.*** for all spaces. | We used: **((?!(UX)|(User Experience)).)***
This excluded an internal space (by key and name) managed separately. | > | Optionally, specify **Page name regex** | You may want to exclude images from your global images page if you have one and you manage the images there separately. | We used: **((?!(Images)|(Number images)).)***
This excluded our global [Images](https://appfire.atlassian.net/wiki/spaces/info/pages/86083606) page and the [Number images](https://appfire.atlassian.net/wiki/spaces/info/pages/86120193) page. | > | Set the **Attachment name regex** | You need to select only images on your site. This assumes images are named with a standard extension. | We used: **.*(\.png|\.jpg|\.jpeg) ** |   # Example Result :info: The following wiki page is a live example of the Attachment Table macro in action: - [Images](https://appfire.atlassian.net/wiki/spaces/info/pages/86083606) (global image page)   # Other Examples Visit our [full list of product examples](https://appfire.atlassian.net/wiki/spaces/TBL/pages/74815984) for additional inspiration!