Inserting the Diary Macro

A Diary is a macro on a page. You insert it once - and from then on everything happens in view mode.

Inserting it

  1. Open the page you want the Diary on and click Edit.

  2. Type /Diary and choose Diary, or open the macro browser and search for it there.

    Screenshot of Confluence page with open macro browser showing Diary
  3. Publish the page.

You now have an empty Diary, with a short welcome message and - if you may edit the page - an editor prompt waiting for the first entry:

Screenshot of Confluence page with empty Diary

Configuring it

Click the macro and choose the configuration button to open the macro settings. Ten settings control the order of entries, the style, where the editor sits, whether a title and the time are shown, how many entries fit on a page, and which template new entries start from. Every one of them is described in Macro Settings.

Every parameter is a display or authoring choice. Changing one never rewrites your entries, so you can experiment freely on a diary that already has content in it.

More than one Diary on a page

You can put several Diary macros on the same page. Each keeps its own entries and its own parameters, so a project page can carry a decision log and a status log side by side without the two mixing.

One Confluence page in view mode with two Diary macros on it.

Moving and copying pages

Because the entries travel inside the page body, copying a page copies its Diary entries and moving a page moves them. There is nothing to re-point afterwards, and no app data left behind.

Next steps