---
title: Pinned results in Search Management portal
slug: graph/docs/pinned-results-in-search-management-portal
docTags: 
createdAt: 2026-07-30T20:30:19.179Z
---

:::hint{type="success"}
**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](docId\:PaScZgTEgFyb9hSRR3G1O).

### 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.

1. Confirm that an administrator has granted Graph access in Admin Center.
2. Enable search hit tracking so that performance data displays on the Overview dashboard. Learn more about [search and hit tracking](docId\:aM0WpNsNXe_n26IhkX5sG)
3. Create a pinned results collection. For implementation details, see [pinned results](docId\:PaScZgTEgFyb9hSRR3G1O).
4. 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.
5. 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.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/_Y1sgxtiTXJ_zrpzbHv_-_3874f72f74c01a2b5b273cac975bf2e10b6522ba007f7ae4b382949789984b16-image.png)

## Create a pinned result

1. Under **Search Tools**, click **Pinned Results**.
2. Click **+ Create Pinned Results**.
3. Complete the following fields:
   - **Search Phrases** – Enter the queries that trigger this pin, separated by commas.
   - **Destination** – Select the content you want to pin.
   - **Language** – Enter the target language code (for example, `en-US`).
4. Click **Create**.

The pinned result takes effect immediately.

## Update a pinned result

1. Click **More options** for the pinned result you want to change.
2. Click **Edit**.
3. Modify the fields as needed.
4. Click **Save Changes**.

Changes take effect immediately.

## Delete a pinned result

:::hint{type="danger"}
**Warning**
Deleting a pinned result cannot be undone.
:::

1. Click **More options** of your desired pinned result.
2. Click **Remove**.
3. Confirm the deletion.