> For the complete documentation index, see [llms.txt](https://support.agentfire.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.agentfire.com/agentfire-idx/property-alerts-and-saved-searches/search-categories-creating-and-updating.md).

# How to Create a Handpicked List of Listings (Search Categories)

How to create a search category, handpick the listings in it, and show it on your website.

A search category is a list of listings you pick yourself, like "Waterfront Picks" or "Past Sales". Unlike a saved search, it only shows the listings you add. It's a great way to show off your expertise.

This only works with AgentFire IDX.

{% stepper %}
{% step %}

### Create the category

Go to **IDX** > **Saved Searches** and open the **Search Categories** tab. Click **New Category**, give it a name and click **Create Category**.

![Naming a new category](https://2039430885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq65vhH2v4k5rpDOha9Vm%2Fuploads%2Fgit-blob-3d3993c31a67a45e63c17d3893ca40fb21df5039%2Fsearch-cat-1-name.png?alt=media)
{% endstep %}

{% step %}

### Add listings

Click **Edit** next to your category, then click **Add New**. Type the listing's address or MLS number. Choose **Active** or **Sold** to search active or sold listings. Click **Include** next to the listing you want.

![Finding a listing and clicking Include](https://2039430885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq65vhH2v4k5rpDOha9Vm%2Fuploads%2Fgit-blob-7ce651854dccc4b44f53f0c8268c7b801f9ab46a%2Fsearch-cat-3-include.png?alt=media)

Click **Add New** again for each listing. To take one out, click **Delete** next to it.

![The listings in a category](https://2039430885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq65vhH2v4k5rpDOha9Vm%2Fuploads%2Fgit-blob-342836155b6f98fa5e001e8847243982952c387c%2Fsearch-cat-4-listings.png?alt=media)
{% endstep %}

{% step %}

### Show it on your website

Each category has its own page. Click the arrow icon next to it to open it. You can share that link or add it to your menu.

To show the listings on another page, copy the code next to the category, like `[afx_search_category id="2"]`. Ask us to add it to the page, or to show the listings in a slider.

![The category's code and the arrow icon](https://2039430885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq65vhH2v4k5rpDOha9Vm%2Fuploads%2Fgit-blob-f576448de947faa44a75bc83eae13f847709b285%2Fsearch-cat-2-list.png?alt=media)
{% endstep %}
{% endstepper %}

Listings stay in your category until you remove them, so check it every so often and take out ones that have sold, unless it's a list of your sales.

## Common Questions

<details>

<summary>I can't find a listing when I search.</summary>

Try the street number and part of the street name, or the MLS number. Check you've chosen **Sold** for a sold listing. If it's still missing, email <support@agentfire.com> with the MLS number.

</details>

<details>

<summary>How do I add a listing to a page like Past Sales?</summary>

If the page shows a search category, add the listing to that category and the page updates by itself. If you're not sure where the page's listings come from, email <support@agentfire.com> with the page.

</details>

<details>

<summary>What's the difference between a search category and a saved search?</summary>

A saved search shows the listings that match your filters, like price and area, and updates on its own as listings come and go. A search category only shows the listings you pick. See [How to Create a Saved Listing Search](/agentfire-idx/property-alerts-and-saved-searches/agentfire-idx-create-a-custom-saved-search.md).

</details>
