Access Keys:
Skip to content (Access Key - 0)

Adaptavist Documentation Move

This documentation is deprecated. Adaptavist's documentation has moved to a new location where it is maintained and updated. Please visit Adaptavist's new Documentation area.

lozenge macro


The {lozenge} macro creates a lozenge button with optional link...

This macro creates a professional lozenge effect that's ideal for creating professional looking buttons or simply highlighting important information.

It's specifically designed to "break" and look ugly if you try and put too much content in to it (although you can change the width to accomodate more content if required). We've done this to ensure the content contained within the lozenge is concise and that in turn leads to an improved experience of people viewing your website.


This macro is used as shown below:

Parameter Required Default Notes
link   If specified, clicking the lozenge will go to the specified link.
color silver The colour of the left portion of the lozenge as shown on the Colors tab.
arrow none or blue Defines which arrow to use on the left portion of the lozenge:
  • none (default if no "link" specified) - the arrow will not be displayed
  • blue (default if a link is specified) - a blue arrow will be displayed
  • green - a green arrow will be displayed
title   The title to show at the top of the main panel.
icon   The Wiki Notation for an attached image (no larger than 48x48 pixels) or even text if desired.
width 347px The width of the entire lozenge in pixels or as a percentage. Specify auto to make the lozenge automatically stretch to fit it's contents.

The body of the macro should contain the summary text in Wiki Markup Editor. This can, for example, be used to place excerpts in to the lozenge using the excerpt-include macro.


You can choose from 9 colours for the left side of the lozenge and whether to show a blue, green or no arrow:

Color No Arrow Blue Arrow Green Arrow


Hints and Tips:

The lozenge is a great way to provide attractive navigation to key areas on a site. Because it limits the amount of text you can put in, you are forced to think of a concise way of describing what the link goes to and this makes your site easier to use.

Frequently Asked Questions:

Q I've put in the name of an icon as shown in the example, but it's not appearing and I get an ugly error message...
A You need to attach the icon to your page or provide a URL to an icon elsewhere - this macro doesn't contain the icons.

See Also

View old comments

Adaptavist Theme Builder Powered by Atlassian Confluence