Display order

Display order is a concept widely used in XenForo.

It allows items to be set in an order relative to one another that is quickly and easily changed.

The system is based on each item having a display order value, which is an arbitrary whole number. Items with higher numbers are displayed after items with lower numbers, as shown in this example, where the item's display order is shown in parentheses:

  • Blue (5)
  • Purple (7)
  • Red (29)
  • Green (1578)

Display order applies only to items with the same (or no) parent item. If an item is a child of another item, it will only be affected by the display order of its sibling children, and not by the display order values of its parent, or children of another parent.

Here's another example showing this, with a list of parent items, each of which have their own child items. Again, the display order value is shown in parentheses:

  • Colors (1000)
    • Blue (5)
    • Purple (7)
    • Red (29)
    • Green (1578)
  • Animals (2000)
    • Badger (100)
    • Hedgehog (101)
    • Otter (102)
  • Fast food (10000)
    • Hamburger (30)
    • Hot dog (50)
    • Fried chicken (75)

In this example, the top-level items (Colors, Animals and Fast food) are ordered by display order values of 1000, 2000 and 10000. These are entirely independent of the values of their child items, which relate only to their own siblings. The color codings help to illustrate the relative display order values.