...or how to display attachments in an unordered list.

Something that bugs me in Confluence is the way that attachments are shown. The default view is a big table with just about all the information related to each attachment.

This is great if you want all this detail, but I'm a simple soul with simple needs.

Krug suggested "Omit needless words". In this case, it's more of "Omit needless metadata".

Less is more

Enter {list-attachments} - a user macro that dispenses with the excess. It displays an unordered list with the filename, file size and last modified date. If there's a comment for the attachment, this is displayed in the link text rather than the filename.

This is a really straightforward view of the attachments on the page.

How do I install {list-attachments} ?

It's pretty easy. As a Confluence administrator, go to Confluence Admin | User Macros and click on Create a User Macro.

Macro name: list-attachments

Template:


## MACRO: list-attachments
## Updated: 2014-05-12
## View page attachments in a simple list
## USAGE: {list-attachments}
## @noparams
#set ($attachmentsList = $content.getLatestVersionsOfAttachments())
#if ($attachmentsList.size() > 0)
<ul>
#foreach( $attachment in $attachmentsList )
#set ($currentAttachmentId = $attachment.id)
#if ($attachment.comment && $attachment.comment.trim().length() > 0)
## Display the comment as the link text instead of the filename
<li><a href="$generalUtil.htmlEncode("${req.contextPath}${attachment.downloadPathWithoutVersion}")">$generalUtil.htmlEncode($attachment.comment)</a></li>
#else
## Display the filename as the link text
<li><a href="$generalUtil.htmlEncode("${req.contextPath}${attachment.downloadPathWithoutVersion}")">$generalUtil.htmlEncode($attachment.fileName)</a></li>
#end
#end
</ul>
#end

Accept the defaults for the other fields, then click on Save

To call the macro in the page type: {list-attachments}

The result:

Now you're left with a simple list of links — much purer than a big fat table of metadata.

For extra points (Updated 2011-03-15)

If you've got a might great slab of files attached to the Confluence page, why not wrap this usermacro in the azList macro:

{azlist}{list-attachments}{azlist}

The result: