Page properties are easy to use, but up to version 5.7 of Confluence provide limited capabilities to select and display the properties. While document properties provide some additional features, people my consider specifying the where clause to constrain the search result as complicated.

If page properties is providing all you'll ever ask for, you should stay with it: it is free and is part of every Confluence installation.

If you are asking for more and paying for additional features that make you more productive is not a problem for you, check out document properties.

The following table lists features that are related to one of the macros discussed, but are implemented by different macros. In this case the macro providing the feature is listed. No extra cost is involved to use the mentioned macros, since all these macros are either part of Confluence or the projectdoc Toolbox Add-on.

Compare the features of the 4 macros: have screenshots showing the macros in action!