> For the complete documentation index, see [llms.txt](https://docs.uichemy.com/llms.txt). > Use it to discover all available pages before exploring further. # Archive & Search Templates Build custom archive layouts and a custom search results page using the Composer widget's loop system. Requires Pro. Archive templates control the layout of category archives, tag archives, author archives, date archives, and custom taxonomy archives, any taxonomy your site registers gets its own Archive target automatically. A Search Results template controls what visitors see after they submit a search query. Both use Composer's loop system to render lists of matching posts. Archive and Search templates require **UiChemy Pro**. See [Free vs Pro](/uichemy-composer/getting-started/free-vs-pro). ### Create an Archive Template 1. Go to **UiChemy → Theme Builder**. 2. Click **+ Add New → Archive** (or **Search Results** for search). 3. It opens in the WordPress editor (Gutenberg) by default, or in Elementor if it's installed and you choose it. Use **Edit** on the template card to reopen it later. 4. Add the **Composer** widget to the canvas. 5. Build your archive layout. 6. Click **Update** to save. Archive templates need a target; Search Results templates need nothing further, see below. ### The `term` Provider in Archive Templates On taxonomy archive pages (category, tag, custom taxonomy), the `term` Twig provider resolves to the current archive term: ```html
Category

{{ term.name }}

{% if term.description %}

{{ term.description }}

{% endif %}

{{ term.count }} articles

``` On author archive pages, use the `user` provider: ```html

Posts by {{ user.name }}

{{ user.name }} ``` ### The Post Loop Use `get_posts` with `paged: current_page()` to render the archive's posts: ```html
{% for post in get_posts({ post_type: 'post', posts_per_page: 9, paged: current_page() }) %}
{{ post.thumbnail.alt }}
{{ post.categories.name }}

{{ post.title }}

{{ post.excerpt|truncate(100) }}

Read More →
{% endfor %}
{{ loop_pagination()|raw }}
``` `current_page()` reads the current page number from the URL (`?loop_page=N`). `loop_pagination()` renders numbered page navigation links. ### Target and Conditions for Archives An Archive template's primary scope is its **target**, chosen when you create it: blog (the main posts listing), author, date, a specific taxonomy (like Category or a custom taxonomy), or "any." Author and Date archives are targets, not conditions, there's no separate condition scope for them. Within a taxonomy target, conditions narrow further: | Condition | What it covers | |---|---| | Post Category (any category) | All category archive pages | | Post Category → specific term | One specific category's archive | | Post Tag (any tag) | All tag archive pages | To apply one template to all categories and another to a specific category, use two templates targeting Category: a broad one with **Include → Post Category (any)**, and a specific one with **Include → Post Category → "News"** (wins for the News category). ### Search Results Template The search results template uses `request.get('s')` to access the search query, and `get_posts` with the `s` parameter to fetch matching results: ```html

{% if request.get('s') %} Results for "{{ request.get('s') }}" {% else %} Search {% endif %}

{% set results = get_posts({ post_type: 'any', posts_per_page: 10, s: request.get('s'), paged: current_page() }) %} {% if results %}
{% for post in results %}

{{ post.title }}

{{ post.excerpt|truncate(150) }}

{{ post.date|date('F j, Y') }}
{% endfor %}
{{ loop_pagination()|raw }} {% else %}

No results found for "{{ request.get('s') }}".

Try different keywords, or browse by category.

{% endif %}
``` Search Results templates don't use conditions, there's nothing to set beyond building and activating the template. If you have more than one active Search Results template, the one you activated most recently is the one that shows. ### Tips On a category archive, pass the current term to `get_posts` using `tax_query`, get the current term slug from `term.slug`: ```twig {% for post in get_posts({ post_type: 'post', posts_per_page: 9, paged: current_page(), tax_query: [{ taxonomy: 'category', field: 'slug', terms: [term.slug] }] }) %} ``` Wrap your loop in `{% if %}...{% else %}...{% endif %}` to show a "no posts" message when the archive is empty. ### Frequently Asked Questions No. Both require **UiChemy Pro**. See [Free vs Pro](/uichemy-composer/getting-started/free-vs-pro). Create two Archive templates that target Category: a broad one for every category, and a specific one for the category you want. The more specific one wins on that category's pages. You can, but only one shows. Search Results templates don't use conditions, so the one you activated most recently is the one visitors see. ### Related See the general template-creation flow this builds on. Narrow this archive down beyond its post type target. Build the post grid this archive template lists. Pull in each looped post's data dynamically. Build the matching single-post view this archive links to.