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 on the Categories tab can extract category names directly from page HTML.
This is different from XPath on Search Configuration > Fields, which extracts indexed field values rather than the page's page_type category.
Use category XPath rules only when the page contains reliable category information that is not already available in normal metadata fields or manual category mappings.
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 | Category |
|---|---|
| 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.
After saving categories, switch to Search Configuration > Scopes. The new category should appear in the Category dropdown without reloading the page. Use Add scopes from current categories to create matching scope rows quickly, then Save.