A dynamic template is not being used
Use this guide when an archive, repeated result or single entry renders with another layout even though the intended HTML template exists.
Choose the correct template family
Go to Settings → POM Theme → Templates → HMTL templates and identify the template’s job:
- An archive template owns the archive shell and contains the result area.
- A feed template renders one item inside a repeated listing.
- A single template renders one content object.
Creating a template does not assign it automatically, and choosing a feed template does not replace the archive shell.
Trace the assignment
- Open the public URL that demonstrates the problem.
- Identify whether it is an archive, a listing item or a single entry.
- Open the relevant content model, listing or template configuration.
- Confirm that the intended template is selected for that exact post type or result context.
- Check the documented assignment priority for a more specific selection.
- Save the assignment and then save the template.
- Reload the same public context in a private window.
Use the same language and visitor state throughout the test. A translated archive or permission-controlled view may resolve to different content or output.
Validate the template’s required structure
For an archive template, place {{archive_results}} once where the results should appear. For a feed template, use feed merge tags that describe the current repeated item. For a single template, use single-context tags and preview it with a representative object.
If the shell changes but items do not, the archive assignment works and the feed template needs attention. If individual item markup changes but the surrounding page does not, the feed assignment works and the archive shell is controlled elsewhere.
Avoid false cache diagnoses
First verify the selector and request context. Then purge the page cache if the saved assignment is correct but old markup remains. Generated CSS does not choose a template, so regenerating styles cannot fix an incorrect assignment.
Expected result
The requested context uses the selected template family, the archive inserts its result area once, and its merge tags resolve against the correct object.
If a custom result falls back
Confirm that the selected template still exists and is readable in the current site. Re-select it, save the owning configuration and test a clean URL without old Faceted Search state.