Pinned results in Search Management portal
Beta Search Management portal is in beta. Access this feature when you have the following:
- Opti ID
- Optimizely Graph instance access
Pinned results (formerly best bets) lock specific content to the top of search results for targeted queries. Use pinned results to promote featured content, surface seasonal products, or display high-priority pages for important queries.
How pinned results work
When a query matches a pinned result, the pinned content displays at the top of search results in the priority order you defined. Users see a consistent, curated experience for the queries you have configured. Learn more about pinned results.
Set up pinned results
The Search Management portal lets content marketers curate pinned results from the portal. Before they can do so, a developer must create a pinned results collection in Optimizely Graph. The search query must then reference that collection's key.
Complete the following setup steps in order.
- Confirm that an administrator has granted Graph access in Admin Center.
- Enable search hit tracking so that performance data displays on the Overview dashboard. Learn more about search and hit tracking
- Create a pinned results collection. For implementation details, see pinned results.
- Retrieve the collection key from the creation response or GET /api/pinned/collections. If your Graph instance contains multiple pinned results collections, the portal uses the first collection the query returns.
- Update your search query to include the collection key in the pinned.collections argument. Do not use the collection id.
After these steps are complete, content marketers can create, update, and delete pinned results from the portal as described in the following sections.
Create a pinned result
- Under Search Tools, click Pinned Results.
- Click Create Pinned Result.
- Complete the following fields:
- Language Routing – Select the language that the pinned result applies to. Leave the field set to Any to apply the pinned result to all languages.
- Destination – Select the content you want to pin.
- Phrases – Enter one search phrase that triggers this pinned result, such as return policy. Do not enter several phrases separated by commas.
- Click Create.
The pinned result takes effect immediately.
How phrases match search queries
Enter phrases that match what visitors type so that each pinned result displays for the searches you intend.
Optimizely Graph applies a pinned result only when the search query matches the whole phrase. The comparison ignores case, but individual words and partial phrases do not match. For example, the phrase return policy matches the query Return Policy but not return or return policy uk.
The portal does not split an entry on commas. If you enter return policy, returns, the portal saves the whole entry as one phrase. That pinned result displays only when a visitor searches for the exact text return policy, returns.
To pin the same content for several phrases, create one pinned result per phrase with the same Destination. For example, create one pinned result for return policy and another for returns.
The Pinned Results table shows only the 20 most recently created pinned results, with no sorting, filtering, or paging. To manage more pinned results, ask a developer to list, filter, and sort them through the REST API. Learn more about the phrases field and the item endpoints in pinned results.
Update a pinned result
- Click More options for the pinned result you want to change.
- Click Edit.
- Change the phrase in the Phrases field.
- Click Update.
Changes take effect immediately.
The portal locks Language Routing and Destination on an existing pinned result. To change the language or destination, delete the pinned result and create it again.
Delete a pinned result
Warning Deleting a pinned result cannot be undone.
- Click More options of your desired pinned result.
- Click Remove.
- Confirm the deletion.