Controlling Block Order

To control the order of blocks in an XML layout update, include a “before” or “after” positioning property in the code. The result is essentially the same as what you can achieve using the Layout Editor to drag built-in blocks from one place to another within a column.

To place a block—either before, or after a specific block—replace the hyphen with the block identifier, as shown in the following examples:

  • before="-"    Places the block at the top of the sidebar, before other blocks.
  • after="-"       Places the block at the bottom of the sidebar, after other blocks.

Code for Positioning a CMS Block

<block type="cms/block" before="-" name="left.permanent.callout">
<block type="cms/block" before="some-other-block" name="left.permanent.callout">
<block type="cms/block" after="-" name="left.permanent.callout">
<block type="cms/block" after="some-other-block" name="left.permanent.callout">


Explore the Knowledge Base