The document of wp_list_pages() is not clear.

[doublehhh]

The document of wp_list_pages() is not clear. Developers can use non-hierarchical post type. It makes them confused.

[swissspidy]

wp_list_pages() does not support setting the post type in $args. The function uses get_pages() which in turn supports that, but not when called via wp_list_pages().

For 39369.patch​ to be true, wp_list_pages() would actually need to support this.

[SergeyBiryukov]

Replying to swissspidy:

wp_list_pages() does not support setting the post type in $args.

I think it does, as it passes the list of arguments directly to get_pages(), and post_type is one of the documented arguments​ in both functions.

I've just tested wp_list_pages() with a hierarchical CPT, and it works as expected.

[swissspidy]

post_type is one of the documented arguments​ in both functions.

Welp, my bad. I seem to have only looked at $defaults and missed it in the docblock of wp_list_pages().

[SergeyBiryukov]

In 40027:

Docs: Clarify that wp_list_pages() and get_pages() only work with hierarchical post types.

Props doublehhh.
Fixes #39369.