> ## Documentation Index
> Fetch the complete documentation index at: https://algolia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Declare and adopt an A/B test winner

> Apply a winning variant's configuration to your control directly from the test page.

export const Application = () => <Tooltip tip="An Algolia application is a self-contained environment with its own indices, configuration, and API keys. Applications don't share data or settings with each other.">
    application
  </Tooltip>;

export const AlgoliaSearch = () => <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 80 80" width="20" height="20" className="inline" fill="none" role="presentation" ariaLabel="Algolia Search">
    <circle cx="40" cy="32" r="28" fill="#5468FF"></circle>
    <rect x="30" y="22" width="20" height="20" rx="10" fill="#fff"></rect>
    <path d="M43 63.5 54.5 60l6 17h-12L43 63.5Z" fill="#36395A"></path>
  </svg>;

Adopting an A/B test winner applies your winning variant's configuration directly to your production search,
eliminating the need to manually copy settings or reconfigure your index.

<Note>
  This action is available only when the declared winner is a variant (not the control).
</Note>

## Before you begin

You'll need:

* **Admin access** to your Algolia dashboard to change index settings and promote configurations

  <Info>
    Users without admin access can declare a winner but can't promote settings to modify index configurations.
    Full admin access is required for the complete adoption process.
  </Info>

* **An A/B test** with at least 80% completion so that the option to declare a winner is available

* **Understanding of your current index configuration** to verify changes are working properly

* **Ready to promote** the settings of your winning test variant to the control index. The entire process takes 5 to 10 minutes for the technical adoption and 2 to 3 hours of monitoring

## Declare A/B test winner

1. Go to the [Algolia dashboard](https://dashboard.algolia.com/explorer/browse) and select your Algolia <Application />.
2. On the left sidebar, select <AlgoliaSearch /> **Search**.
3. On the [**A/B testing**](https://dashboard.algolia.com/ab-tests/overview) page, select your A/B test you want to process.
4. On the A/B test detail page, select the variant you want to choose as winner and click **Declare winner**.

<img src="https://mintcdn.com/algolia/0u_XqgAn7MC5F_qG/images/guides/analytics/one-touch/declare-winner.png?fit=max&auto=format&n=0u_XqgAn7MC5F_qG&q=85&s=32df84fa2fa57a3d9ff9aa675fabc61a" alt="Screenshot of the A/B test details page of the Algolia dashboard showing three test variants with Declare winner buttons" width="3022" height="1648" data-path="images/guides/analytics/one-touch/declare-winner.png" />

Your A/B test must be at least 80% complete (based on its scheduled duration) before you can declare a winner.
After declaring a winner, you can immediately adopt the winning configuration.
(Declaring a winner itself doesn't change your indices).

## Promote settings

After declaring a winner, click **Promote settings** to copy the winning configuration to your control.

<img src="https://mintcdn.com/algolia/0u_XqgAn7MC5F_qG/images/guides/analytics/one-touch/promote-settings.png?fit=max&auto=format&n=0u_XqgAn7MC5F_qG&q=85&s=ed47ee4fe5ce3b88d4f42640cee0a107" alt="Screenshot of the A/B test details page with three test variants with Variant B showing a Promote settings button" width="3024" height="1646" data-path="images/guides/analytics/one-touch/promote-settings.png" />

<Note>
  **Adoption window:** You have 14 days after your A/B test ends or you stopped it to adopt the winning configuration. After this period, you'll need to apply the settings manually to your index.
</Note>

### Confirm promotion

To confirm updating the index settings:

* If the winning variant uses the same index as the control: Enter `COPY`
* If the winning variant uses a different index as the control: Enter `UPDATE`

Click **Confirm** to proceed.

## Configuration changes during adoption

The adoption action copies most configuration settings from your winning variant to your control, but there are some important limitations to be aware of.

### What gets applied

* Update the control's index settings to match the winning variant (or custom search parameters if variant index is the same as the control's).
* Toggle feature settings on or off to match the winner (limited to):
  * [Dynamic Re-ranking](/doc/guides/algolia-ai/re-ranking)
  * [NeuralSearch](/doc/guides/algolia-ai)
  * [Personalization](/doc/guides/personalization/classic-personalization/what-is-personalization)
  * [Advanced Personalization](/doc/guides/personalization/advanced-personalization/what-is-advanced-personalization)

### What doesn't get modified

* **Records**: Your actual data is never modified.
* **Synonyms and rules**: These remain unchanged during adoption.
* **Replica limitations**: If the control is a [replica](/doc/guides/managing-results/refine-results/sorting/in-depth/replicas) (**virtual or standard**), the system applies only the subset of index settings [listed here](/doc/guides/managing-results/refine-results/sorting/in-depth/replicas#supported-index-settings-for-virtual-replicas) during adoption.

## Verify adoption

After promoting settings, verify the changes work as expected:

1. **Check your index configuration** in the dashboard to confirm your control index received the winning variant's settings.
2. **Check your analytics** for any unexpected changes in the next 2 to 3 hours.

## Revert settings

You have a 15-day window after your A/B test ends or you stopped it to revert the adoption.

To revert to your previous settings:

1. Open the A/B test details page in the dashboard.

2. On the control variant, click **Revert**.

   <img src="https://mintcdn.com/algolia/0u_XqgAn7MC5F_qG/images/guides/analytics/one-touch/revert-settings.png?fit=max&auto=format&n=0u_XqgAn7MC5F_qG&q=85&s=8d7ddbb90f640831db1966ff00578e02" alt="Screenshot of the A/B test details page with three variants showing the Revert settings button for the control variant" width="3024" height="1644" data-path="images/guides/analytics/one-touch/revert-settings.png" />

3. Confirm by entering `REVERT` and clicking **Confirm**.

4. The original winning variant still appears as the winner, but no longer shows as "promoted".

<img src="https://mintcdn.com/algolia/0u_XqgAn7MC5F_qG/images/guides/analytics/one-touch/settings-reverted.png?fit=max&auto=format&n=0u_XqgAn7MC5F_qG&q=85&s=c512cc902ec0d35c8dd7641654a69196" alt="Screenshot of a dashboard showing an 'A/B test' page with a 'Settings reverted' notification and a 'Control' variant having its settings reverted." width="3022" height="1638" data-path="images/guides/analytics/one-touch/settings-reverted.png" />

### Important reversion details

* After reverting, you won't be able to promote settings again for this A/B test.
* The same limitations that applied during initial adoption also apply when reverting (replica restrictions, feature settings constraints).
* Only the settings that were originally applied during adoption can be reverted.

<Info>
  **Need help?** If you experience unexpected behavior after reverting settings, contact [Algolia support](https://support.algolia.com/hc/en-us/requests/new).
</Info>

## See also

* [Create and run an A/B test](/doc/guides/ab-testing/what-is-ab-testing/how-to/create-and-run-an-ab-test)
* [How to read your A/B test results](/doc/guides/ab-testing/how-to-read-your-a-b-test-results)
