Airgentic Help
Indexed fields are the values stored for each page or document in the search index.
Fields are used for result display, filtering, sorting, AI answers, and optional plain-text query matching.
Most services use these standard fields:
| Field | Purpose |
|---|---|
title |
Result title and search ranking. |
description |
Result summary. |
image |
Result thumbnail. |
date |
Publication or update date. |
URL |
Result link. |
body |
Main searchable page text. |
page_type |
Search result category. |
For existing web crawl services, title, description, image, and date are usually configured through the crawler's Standard Result Fields tab. Additional indexed fields are managed through Search Configuration > Fields.
Open the web crawl configuration screen and go to Standard Result Fields.
Standard result field mappings define which metadata fields should be checked for each standard result field, such as title, description, image, and date.
For example, a title field might check:
title_element
og:title
title
dc.title
The first non-empty value is used.
See Crawler Standard Result Fields.
In newer services, standard fields can also be managed through Search Fields. Existing services do not switch automatically. If Use Search Fields for standard result fields is not enabled, the standard title, description, image, and date rows shown in Fields are informational/read-only and the web crawl Standard Result Fields settings still take precedence.
If Use Search Fields for standard result fields is enabled, the Search Fields definitions become the source for those standard fields and the web crawl mappings no longer control them.
Advanced Site Search can use additional Search Fields, such as:
hostsectionformatdeliverysubject_areaThese fields can be used for filters, result-card badges, search scopes, sorting, plain-text query matching, or search context controls.
Open Search Configuration > Fields to review or configure Search Fields. This screen writes to the service search descriptor and is the long-term place for fields used by filters and result cards.
Each Search Field can define:
deliveryThe field editor includes guidance beside the Field type selector. Use Keyword / filter value for most exact filters, such as delivery, credential, format, or subject area. Use Hierarchy / drill-down path when the value represents levels, such as Programs > Engineering > Civil.
For example, a Delivery field might check these HTML metadata names in order:
bcit.delivery
programDelivery
et:delivery
The first non-empty value is used.
The Advanced settings section is grouped by purpose:
0 for fields that should only be used as filters, badges, sorting fields, or layout data.Online, Burnaby, enable Multi-valued and split on ,.> in Programs > Engineering > Civil. Max hierarchy depth controls how many levels are indexed.The internal Role field is only shown for standard result fields such as title, description, image, and date. The stored Elasticsearch field preview appears after a field has been saved.
Some advanced settings may initially be visible to superusers or managed by Airgentic support.
The Plain-text search boost setting applies to descriptor-backed Site Search pages and only to fields with type Text / searchable content.
Use it when a custom text field should be searched as part of a visitor's normal typed query. For example, a program_name or course_summary field might have a positive boost so searches match against that text as well as the standard page title and body.
The value range is 0 to 5:
0 means the field is not included in normal typed query matching.Filters and result-card badges do not automatically make a field searchable. A keyword field such as delivery, credential, or campus can still be used for filters and badges, but it is not searched by normal typed queries unless it is modelled as a text field with a positive plain-text search boost.
The standard title and body fields are always searched as the baseline.
Multi-value and hierarchy settings solve different problems:
| Setting | Use when | Example |
|---|---|---|
| Multi-valued | One page can have more than one value for the same field. | Online, Burnaby becomes Online and Burnaby. |
| Hierarchy / drill-down path | One value represents levels in a tree. | Programs > Engineering > Civil. |
A hierarchy field can also be multi-valued if a page can belong to multiple hierarchy paths, but the hierarchy delimiter and maximum depth are controlled by the Field type, not by the Multi-valued checkbox.
When Show this field as a search filter is enabled, the editor shows filter controls and a small preview of the selected filter style.
Common choices:
Use Match any selected value for most filters. Use Must match all selected values only when documents can contain multiple values and visitors need results that contain every selected value.
To decide which filters appear in each search tab, configure scopes on Search Configuration > Scopes. See Configuring Search Scopes.
To show a field directly on search results, add it as a metadata badge or custom layout block on Search Configuration > Result Cards. See Configuring Result Cards and Layouts.
Computed fields are created from existing page information rather than extracted from metadata.
Examples:
| Computed value | Example |
|---|---|
| Host | www.example.edu |
| URL section | Programs > Engineering |
| URL depth | 3 |
Computed fields are useful for current-site search and hierarchical filters.
In Search Configuration > Fields, choose Computed from URL as the source, then select the computed value.
Adding or changing indexed fields may require reprocessing content.
| Change | Typical requirement |
|---|---|
| Change result display only | No reprocess. |
| Add a field from metadata | Re-extract already crawled pages. |
| Add a computed field | Rebuild index metadata. |
| Change a field type | Full reindex. |
The admin console should show the expected impact before saving changes.