Page History

There seems to be some confusion about how to select the layout that is shown by default, this document hopes to make the situation clearer.In builder it is possible to affect the layout used to present content in many ways, the simplest of these is likely to be the default layout functionality in theme administration or through setting the global layout

Space layout defaulting

When a space is displayed the following sequence is observed when working out which layout should be used

...

You can specify a layout to be latched either through the URL as shown above, or through the {use-layout:LAYOUTID|latch=true} macro ... this will force the rest of the user's session to be displayed through the latched layout unless the user comes across another url/macro that latches them to a different layout, or unlatches the layout selection.

{use-layout} macro

The use-layout macro can be used to override the default layout selection on a page-by-page basis, it may also be used to define/undefine a latch, it is often used in combination with the builder-show macro to change the layout based on the content being viewed or even the platform viewing the content (eg: blackberry).

Space Layout Selection

When you use the choose-layout screen for a space, this The space layout chooser defines the layout that has been selected for that space, if no layout has been specificly specifically chosen for that space the default layout for that type of space (global/personal) will be used.

Default layout selection

The default layout selection defines the layout id that should be used when a space does not have a specific its own layout selected, if there is no default layout selected then the global layout will be used.

Global Layout Selection

This screen serves the same function selection is similar to as the space-layout selection in that it defines uses the layout chooser to define which layout should be used for global pages (eg dashboard), if no global layout has been selected for global spaces chosen then the inbuilt builder DEFAULT layout will be used.

The DEFAULT layout

The DEFAULT layout is a read-only base of internal default data that all layouts can inherit from, it allows new features to be added while providing sensible default values for those features. It is very basic so as to interfere as little as possible with your custom layouts built on top of it, however this means that it's more than a little ugly!