Introduces the [list-pages], [sibling-pages] and [child-pages] shortcodes for easily displaying a list of pages within a post or page.

Ben Huson

Aaron Harp

Introduces the [list-pages], [sibling-pages] and [child-pages] <a href="https://codex.wordpress.org/Shortcode_API" rel="nofollow ugc">shortcodes</a> for easily displaying a list of pages within a post or page. Both shortcodes accept all parameters that you can pass to the <a href="https://codex.wordpress.org/Template_Tags/wp_list_pages" rel="nofollow ugc"><code>wp_list_pages()</code></a> function with the addition of a class parameter.
<h4>Example Usage</h4>
List pages sorted by title
<pre><code>[list-pages sort_column="post_title"]
</code></pre>
List pages but exclude certain IDs and set the class of the list to “my-page-list”
<pre><code>[list-pages exclude="17,38" class="my-page-list"]
</code></pre>
Show excerpt (for pages excerpt support will need adding manually or via the <a href="https://wordpress.org/plugins/page-excerpt/" rel="ugc">Page Excerpt</a> plugin)
<pre><code>[list-pages excerpt="1"]
</code></pre>
List the current page’s children, but only show the top level
<pre><code>[child-pages depth="1"]
</code></pre>
List the current page’s siblings and their subpages
<pre><code>[sibling-pages depth="2"]
</code></pre>
<h4>Default Arguments</h4>
The default values are the same as for the <a href="https://codex.wordpress.org/Template_Tags/wp_list_pages" rel="nofollow ugc">wp_list_pages()</a> function except for title_li which defaults to nothing. If a class is not specified, a default class of either “list-pages”, “sibling-pages” or “child-pages” is given to the UL tag. In addition, the echo parameter has no effect.
In addition to the <a href="https://codex.wordpress.org/Template_Tags/wp_list_pages" rel="nofollow ugc">wp_list_pages()</a> arguments, you can also specify:
<ul>
<li>list_type (string) List tag. Defaults to <code><ul></code>.</li>
<li>exclude_current_page (int) Exclude the current page. Defaults to <code>0</code>.</li>
<li>excerpt (int) Show the page excerpt. Defaults to <code>0</code>.</li>
</ul>

Alternatives to List Pages Shortcode

Top alternatives