Showing content based on Decorator

Using decorators to display or hide content is a powerful way to flexible layouts that adapt to according to the type of page being viewed.

What is a decorator?

A decorator is template that is applied to content. Confluence passes a decorator to Theme Builder. You can use this decorator to display content using the {builder-show} or {{builder-hide} macros.

How to show content in spaces.

Spaces use three different decorators, space, page and blogpost. You can combine multiple decorators in one {builder-show} statement like this:

{builder-show:decorator=space,page,blogpost} using the space decorator {builder-show}

How to show content at global level.

Pages that use the global decorator include, Dashboard, RSS Feed Builder and People Directory. The Popular Labels page, however uses its own decorator, labels. Search Site also uses it own, search.
So to apply content to Dashboard, RSS Feed Builder, People Directory, Popular Labels and Search Site. We would do the following:

{builder-show:decorator=global,labels,search} using the global decorator {builder-show}

Some pages that you may think would have global their decorator in fact have a null value instead namely Login, Sign Up For Confluence and Create Space.
Pages associated with user profiles such as User Profile, Edit My Profile, Personal Labels, Watches and Drafts use the profile decorator. Its worth noting however that a personal space will use the same decorators as a normal space.

Switching layout based on decorator.

You can use {use-layout} macro with an builder-show macro to switch layouts based on decorator.

Example switching to a different layout based on decorator.

{builder-show:decorator=printable}{use-layout:LAYOUTID}{builder-show}

Current decorators.

These are some of the current decorators.

Decorators, Contexts and Modes for pages in Confluence.