Working with tokens
Tokens give you the ability to write dynamic search queries by using the special syntax {TokenName}.
Tokens are case insensitive
Page tokens
| Token | Definition |
|---|---|
| {Page.<FieldName>} | The value of a field on the page from where the query was issued. For example, if the page from where the query was issued contained a site column named "ContentOwner," specifying {Page.ContentOwner} would allow you to query for the value of "ContentOwner." FieldName is the internal name of the field. When used with taxonomy columns, use {Page.<FieldName>.Label} or {Page.<FieldName>.TermID} |
Connections tokens
Tokens related to connected Web Parts in the Search Results.
These tokens can be used in the 'PnP Modern Search Core Components Search Results' and 'PnP Modern Search Core Components Search Box' Web Parts.
You can escape curly braces characters using '\' to avoid: ex: DepartmentId:\{edbfd618-ef1d-4cc5-a214-95bf44ddf4ee\}
| Token | Definition |
|---|---|
| {inputQueryText} {searchTerms} | The query value entered into a search box on a page. The value depends on the configuration of input text connection of the Search Results Web Part. |
| {verticals.<value|name>} | If connected, get the current selected vertical tab name or associated value. |
Context tokens
| Token | Definition |
|---|---|
| {PageContext.<PropertyName>} | Resolves current SPFx page context related tokens. You can use deep paths here to access properties. Ex: {PageContext.site.absoluteUrl}. |
| {LegacyPageContext.<PropertyName>} | Resolves current SPFx legacy page context related tokens. You can use deep paths here to access properties. Ex: {LegacyPageContext.aadTenantId}. |
| {QueryString.<ParameterName>} | A value from a query string in the URL of the current page. For example, if the URL of the current page contains a query string such as ItemNumber=567, you could obtain the value 567 by specifying {QueryString.ItemNumber}. |
| {CurrentDisplayLanguage} | The current display language based on MUI in ll-cc format. |
| {CurrentDisplayLCID} | Numeric value of the current display language based on MUI in ll-cc format. |
| {TenantUrl} | URL of the tenant (root site) |
Site, web, hub, etc. tokens
Except for {Hub}, these a shortands to the {PageContext} tokens. They returns the same values. <PropertyName> is case sensitive.
| Token | Definition |
|---|---|
| {Site.<PropertyName>} | Resolves current site related tokens. You can use the 'Debug' layout and the context property to see all available values for a site. Ex {Site.id._guid} or {Site.absoluteUrl}. |
| {Hub.<PropertyName>} | Resolves current hub site related tokens. Valid property names are {Hub.HubSiteId}, {Hub.Id} and {Hub.IsHubSite} You can target a hub with the template: DepartmentId:\{\{Hub.HubSiteId\}\}. |
| {Group.<PropertyName>} | Resolves current Office 365 group related tokens. You can use the 'Debug' layout and the context property to see all available values for a site. |
| {List.<PropertyName>} | Resolves current list related tokens. Ex {List.id._guid} or {List.absoluteUrl}. |
| {Web.<PropertyName>} | Resolves current web related tokens You can use the 'Debug' layout and the context property to see all available values for a site. Ex {Web.id._guid} or {Web.absoluteUrl}. |
User tokens
| Token | Definition |
|---|---|
| {User} or {User.Name} | Display name of the user who issued the query. For example, this value can be used to query content of the managed property Author. |
| {User.Email} | Email address of the user who issued the query. For example, this value can be used to query content of the managed property WorkEmail. |
| {User.PreferredContentLanguage} | Language as specified as Preferred Content Language in the profile of the user who issued the query. |
| {User.PreferredDisplayLanguage} | Language as specified as Preferred Display Language in the profile of the user who issued the query. |
| {User.<property>} | Any property from the user profile of the user who issued the query — for example, SPS-Interests, userprofile_guid, accountname, etc. including custom properties. |
Date tokens
| Token | Definition |
|---|---|
| {CurrentYear} | Todays's date four digits, 2018 |
| {CurrentMonth} | Today's month, 1-12 |
| {CurrentDate} | Today's date, 1-31 |
| {Today+/- <integer value for number of days>} | A date calculated by adding/subtracting the specified number of days to/from the date when the query is issued. Date format is YYYY-MM-DD (Ex: {Today+5}) |
SharePoint search query variables
Supported variables
The SharePoint Search engine already supports tokens by default (i.e query variables, ex: {Site.ID}). You can use them in the Query template field only. To see the all the supported tokens natively, refer to the Microsoft documentation.
Use the 'OR' operator
To deal with mutli valued properties (like taxonomy multi or choices SharePoint fields), you can use the 'OR' operator syntax {|<property><operator><multi_values_property>}. The search query will be expanded to the following KQL query:
((<property><operator><value_1>) OR (<property><operator><value_2>) OR (<property><operator><value_3>) ...)
Examples:
- Using an user profile multi values taxonomy property:
{|owstaxidmetadataalltagsinfo:{User.SPS-Hashtags}} - Using a page multi values taxonomy property:
{|owstaxidmetadataalltagsinfo:{Page.myTaxonomyMultiColumn.TermID}}or{|owstaxidmetadataalltagsinfo:{Page.myTaxonomyMultiColumn.Label}} - Using a page multi values choice property:
{|RefinableStringXX:{Page.myChoiceMultiColumn}}