Understand template assignment priority
Creating a template and selecting a template are separate actions. When a design is not appearing, identify the page layer first and then inspect the setting that owns that layer.
Archive shell
A supported archive uses the custom archive template selected under Sidebar layout for WordPress post archives or Archive layout for POM custom post type and WooCommerce product archives.
The archive shell does not select the HTML for each result. Place {{archive_results}} in the shell and configure its cards separately.
Result item
POM resolves a feed template in this order:
- An explicit non-default template selected by the Listings (Feed) instance.
- The Custom result template assigned to the current context when the listing uses its default template.
Context settings include post archives, POM custom post type archives, product archives, author pages and search results.
The result wrapper is independent. It controls the arrangement of items, while the custom result template controls each item's markup.
Single item
For WordPress posts, the template selected under Settings → POM Theme → Templates → Blog → Post single → Layout style controls the single body.
For a POM custom post type, the post type's Single layout controls its single body. A permission rule can display its configured fallback template when the visitor is not allowed to view the normal content.
Practical example
Suppose a custom post type archive uses:
Directory shellas Archive layoutGridas Results wrapperDirectory cardas Custom result template
Directory shell must contain {{archive_results}}. Grid arranges the results. Directory card is rendered once per item.
If a Listings (Feed) element on another page explicitly selects Compact card, that element uses Compact card instead of the archive context's default.
Verification
- Confirm you edited the correct template type.
- Confirm the template is selected in the setting for the current URL.
- Confirm an explicit Listings (Feed) choice is not overriding its default.
- Confirm the archive shell contains
{{archive_results}}. - Save theme options and reload the public page.