Airgentic Help
Search result categories group indexed pages into meaningful result types such as Products, Support, News, Programs, or Courses.
Open the Search Configuration screen and use the Categories tab to configure result categories. Search synonyms and phrase rules are managed on the Settings tab.
Categories are different from Search Fields and scopes. Categories decide which result type a page belongs to, such as Programs or News. Search Fields provide extra indexed values, such as Delivery or Credential. Scopes decide which category tabs appear in the search UI and which filters appear within each tab.
Manual mappings are rules created by an administrator. They are evaluated before auto-generated mappings.
Each mapping can include:
| Field | Description |
|---|---|
| Display Title | The category label shown to users. |
| Search Boost | A ranking adjustment for documents in this category. |
| URL Contains | Matches pages whose URL contains a specified string. |
| Metadata Contains | Matches when a metadata field contains a value. |
| Metadata Is | Matches an exact metadata value. |
| Metadata Matches | Matches a regular expression. |
Use manual mappings when you know exactly which pages belong in a category.
When enabled, Airgentic analyses crawled URLs and content to suggest categories.
Auto-generated categories appear in the Auto Mappings section.
Actions:
Override and Mute usually require an index update before search results change.
URL path depth is a legacy fallback that creates categories from URL segments.
Example:
https://example.edu/programs/engineering/page.html
1 -> Programs2 -> EngineeringUse this only when manual or AI categorisation is not suitable.
Advanced XPath rules can extract category names directly from page HTML.
Use XPath categories only when the page contains reliable category metadata that is not already available in normal metadata fields.
Changing category mappings affects the category assigned to indexed documents. After saving, you may be asked whether to start an index update.
Leave Initiate index update now enabled when you want changes to appear in search results as soon as possible.
If you also need category-specific filters, configure the indexed values on Search Configuration > Fields, enable the filters on Search Configuration > Filters, then choose where they appear on Search Configuration > Scopes.
To show categories such as Programs, Courses, or News as top-level search tabs, configure scopes on Search Configuration > Scopes.
A typical category scope maps one tab to one page_type value:
| Scope | Page type |
|---|---|
| Programs | Programs |
| Courses | Courses |
| News | News |
Scopes can also control which filters are shown for each category, which result card is used, and the default sort order for that tab.