Airgentic Help
Search scopes control the top-level search views or tabs visitors use to move between result types.
Examples:
Scopes are configured from Search Configuration > Scopes.
A scope can control:
| Setting | What it does |
|---|---|
| Label | The tab name visitors see, such as Programs. |
| ID | The stable internal name used in configuration and URLs, such as programs. |
| Category | The indexed category this scope filters to, such as Programs. |
| Visible | Whether the scope appears as a tab in the search UI. |
| Order | The row order in the Scopes editor. Drag scopes to reorder; search tabs follow this order (after the optional Ask tab). |
| Filters shown in this scope | Which enabled Search Fields appear as filters when the scope is active. |
| Sort | The default sort for this scope, such as relevance or date order. |
| Sort options shown in this scope | Which sort choices visitors can see when this scope is active. |
| Result card | The result card used for this scope, usually default. |
| Advanced filter JSON | A power-user override for unusual scope filters. |
For most services, each scope maps to a page_type value. For example, the Programs scope filters results where page_type is Programs.
Scopes work with categories and Search Fields:
page_type assigned to each indexed page.delivery, credential, or subject.Example:
| Scope | Category | Filters shown |
|---|---|---|
| All | All results | No filters, or broad filters only. |
| Programs | Programs |
Format, Delivery, Credential, School. |
| Courses | Courses |
Course Location, Course Start Date, Course Subject. |
| News | News |
Date, Topic. |
The Global Scope Settings panel controls which scope is selected when search first opens and when a visitor runs a query without an explicit scope in the URL.
| Setting | Description |
|---|---|
| Default scope | The scope selected when search first opens and when a query has no explicit scope in the URL. It must be visible. Changing this updates which tab is active and which results are shown for new searches. |
Use the Default scope dropdown to choose the tab visitors land on — for example Courses & Qualifications instead of All. Visitors can still switch to All or any other visible tab. Choosing All explicitly shows unfiltered results across every category.
The scope rows below are exactly what the search UI shows. Use each scope's Visible toggle to show or hide that tab. To hide the cross-category All tab, expand the All scope row and uncheck Visible.
New categories are not added to the scope list automatically. After saving categories on the Categories tab, use Add scopes from current categories on the Scopes tab to bring in detected categories, then Save. Category and field dropdowns refresh after each save, so you can move between tabs without reloading the page.
For enterprise-style search pages, it is usually best to configure the important scopes explicitly so their filters and default sort are predictable.
Most services include an All scope with ID all. This scope searches across every category rather than filtering to one page_type.
Use the All scope's Visible toggle to control whether the All tab appears in search. There is no separate global Show All tab setting — visibility is controlled per scope like every other tab.
If All is hidden, choose a different visible scope as the Default scope, such as your primary category tab.
Each scope can choose a result card.
Use the default card when all results should look similar. Use different cards when a scope needs different information or visual treatment. For example, Programs might use a media card with credential and delivery badges, while News might use a compact card with a date badge.
Create and edit cards on Search Configuration > Result Cards, then assign them from the scope editor.
See Configuring Result Cards and Layouts.
The Category dropdown is built from:
page_type values, when availableIndexed values appear after crawling or reindexing. If the value you need does not exist yet, use Custom value so you can configure the scope before indexing is complete.
After you save a new category on the Categories tab, switch to Scopes and the new category should appear in the Category dropdown immediately. You do not need to reload the browser page.
Each scope can have two default sorts and a curated list of sort options shown to visitors.
Relevance uses the normal Airgentic hybrid ranking. Field-based sorts, such as date or alphabetical order, use eligible indexed fields.
Sort options are generated from Search Fields that can safely be sorted, including:
Text and hierarchy fields are not usually shown as sort options.
The scope's configured Sort is the default selected option when the visitor has typed a query. Sort when no query is used when the search box is empty, such as a browse or landing view. When it is not set, Airgentic defaults to Date, newest first if a date sort exists; otherwise it falls back to Sort.
Sort options shown in this scope controls the dropdown list users can choose from. This is useful when the full generated list is too long, or when some sorts only make sense for particular tabs. Both default sorts are always included in the exposed options.
For example, a Programs scope might expose Relevance, Credential, Delivery, and School sorts, while a News scope might use Relevance for typed searches and Date, newest first when no query is entered.
When visitors change the sort in the search UI, that choice applies while the query remains in the same empty or non-empty state. Typing a query applies the scope's Sort. Clearing the query applies Sort when no query. If a visitor arrives with a URL requesting a sort that is not exposed for the active scope, Airgentic falls back to the matching default for the current query state.
Most scopes should use the normal Category dropdown.
Use Advanced filter JSON only when a scope needs a custom filter that cannot be represented by a single page_type value. For example, Airgentic support may use it for a scope that combines several categories or applies a more specific metadata filter.
When Advanced filter JSON is supplied, it overrides the normal Category setting for that scope.
Catalog agents (for example a Study Pathways Concierge or Learning Advisor) search within the same scopes you configure here — such as Programs or Courses & Qualifications. The scope decides which results and which filter pool apply.
Search Configuration > Scopes controls which filters appear on the public search page for each tab. Search Configuration > Catalog Search controls which of those filters are also Available to AI for structured agent plans.
Configure scopes and filters first, then enable catalog facets on the Catalog Search tab. See Catalog Search.
Changing which filters appear in a scope, which tabs are visible, or which result card a scope uses usually does not require reindexing.
Reindexing or reprocessing may be needed when:
page_type valuesXPath and JSON-LD field changes require HTML Processing. URL mapping rules and other computed URL fields usually require an index update.
Use Search Configuration > Preview or the live search page to confirm scopes, filters, counts, and sorting after saving.