The Search Configuration screen controls how pages are categorised in search results and how user queries are interpreted before being sent to the search engine.

The screen is organised into tabs. Use Guide for a quick mental map, Settings for query synonym rules, Categories for result category mappings, Fields for indexed Search Fields, Filters for visitor-facing filter controls, Scopes for search tabs and scope-specific behaviour, and Result Cards for result layouts and metadata badges. Some advanced tabs, including Preview and Superuser, may be visible only to Airgentic support or superusers.

Search Page URLs

Inline and per-slot search pages use standard, bookmarkable URL parameters so search result pages can be shared.

For example, an existing website search form can submit to /search?query=engineering. Airgentic will read the query from the page URL, then update the URL as the visitor changes scopes, filters, sort order, or pagination.

Search Page Styling

Airgentic search uses one default DOM for new search pages. It includes stable Airgentic classes such as air-search-nav, air-search-facet, and hit-card, along with common search and Bootstrap-style classes such as nav-tabs, nav-item, search-results, search-facet, card, pagination, and page-link.

This makes it easier to reuse an existing search stylesheet from a previous search platform. Airgentic support can add external search stylesheet URLs on the Superuser tab. The Airgentic-managed style.css still loads last, so the Design screen can be used for final overrides.

Search Ask Tab

The Settings tab can show an optional Ask tab beside the normal search scopes. When enabled, visitors can switch from search results into the service hub and ask a question without leaving the search page.

The Ask tab uses the same service hub configuration and chat agent as the rest of the site. If the chat agent capability is disabled for the search UI, the Ask tab is hidden even if the setting is enabled.

Search Result Categories

Categories let you group indexed pages into named buckets (e.g. Products, Support, News) that appear as filters or labels in search results. Each category has matching rules that determine which pages belong to it. Configure these on the Categories tab.

AI Auto-Categorization

When enabled, Airgentic analyses each page's URL and content during indexing and automatically assigns a category. AI-generated categories appear in the Auto Mappings section below the manual ones.

When disabled, the legacy URL Path Depth setting becomes available as a fallback.

URL Path Depth (Legacy)

Only shown when AI Auto-Categorization is disabled. Automatically categorises pages based on their URL path structure.

Set a number to pick the URL path segment used as the category name:

• A value of 1 for https://example.com/services/complaints/page.html → category Services
• A value of 2 for the same URL → category Complaints

Leave blank to disable URL-depth categorisation.

Manual Mappings

Manual mappings are human-defined rules evaluated in order. The first rule that matches a page's URL or metadata wins.

Default

The fallback label applied to pages that don't match any manual or auto mapping. Set a Default Type Title (e.g. General) so uncategorised pages still have a meaningful label rather than appearing blank.

Adding a Mapping

Click Add Type to create a new mapping. Each mapping has:

Click Remove Type at the bottom of a mapping to delete it.

Auto Mappings (AI-Generated)

Visible only when AI Auto-Categorization is enabled. Shows categories automatically generated during the last crawl, including how many documents each covers.

Auto mappings are read-only — they are regenerated by the AI each crawl. Two actions are available for each:

• Override — Copies the auto mapping into the Manual Mappings section so you can customise it (rename it, adjust its rules, or add a boost). Once overridden, the manual version takes precedence.
• Mute — Suppresses this auto-generated category so it is never applied to matching pages. Useful for categories the AI generates that you don't want.

Both actions require a reindex to take effect.

Advanced Options: XPath-Based Categories

Expand Advanced Options to configure XPath expressions that extract category names directly from page HTML at crawl time.

• Each XPath is evaluated against the page's HTML. The text found at the XPath becomes the category name (first letter capitalised).
• XPaths are evaluated after explicit manual mappings.
• Example: //meta[@name='document-type']/@content reads the document-type meta tag.

Search Scopes and Filters

Scopes control the search tabs visitors see, such as All, Programs, Courses, or News.

Use Search Configuration > Scopes to choose:

• which scopes are visible
• which page_type value each scope filters to
• which filters appear in each scope
• the default sort for each scope

Search Fields must be created and enabled as filters before they can be shown inside a scope.

See Configuring Search Scopes.

Result Cards

Result cards control how search results are displayed, including the layout, thumbnail treatment, summary, and metadata badges.

Use Search Configuration > Result Cards to choose a built-in layout or create a custom structured layout for a result card. Then assign result cards to scopes on the Scopes tab.

See Configuring Result Cards and Layouts.

Curated Results

Curated results let you promote a specific result for a matching query. Use them for official pages, high-value tasks, or common searches where one result should be shown first.

Configure curated results on the Settings tab.

Each rule includes:

• Trigger query: the query text that activates the rule.
• Match type: exact query, contains phrase, or contains all words.
• Scope: all scopes or one specific search tab.
• Result type: an indexed page or a manually curated result.

An indexed page uses a URL that already exists in the search index. Airgentic fetches that indexed result and promotes it above the organic results.

A curated result does not need to exist in the index. You provide the title, URL, description, optional image, and optional category yourself.

Curated result changes take effect without reindexing.

Search Synonyms

Synonym rules let you modify user queries before they reach the search engine, improving recall when users phrase things differently from how the content is written.

Configure synonym rules on the Settings tab.

The Settings tab also includes Search AI Answer, which controls whether the search UI may show an AI-generated answer above search results. Turning this off keeps normal search results available, but suppresses generated answers in the search experience.

Add

When a query contains term X, also search for term Y (in addition to X). Use this for abbreviations, alternative spellings, or related terms.

• Example: X = "FAQ" → Y = "frequently asked questions"

Replace

When a query contains term X, replace it with term Y. X is removed from the query and Y is used instead.

• Example: X = "T&Cs" → Y = "terms and conditions"

Delete

Remove a term from all queries. Useful for filtering out noise words specific to your domain.

• Example: delete "pdf" so searches for "application form pdf" become "application form".

Saving

Click Save Configuration. If you have changed any category mappings (Manual Mappings or XPath-Based Categories), a confirmation dialog will appear with an option to Initiate index update now. Leave this checked to immediately start reindexing so the new categories take effect. Uncheck it if you want to batch changes and trigger reindexing manually later.

Changes to Curated Results and Search Synonyms take effect without reindexing.