---
title: "Clearwinner App Installation Guide"
description: "Save time with the ClearWinner app by automating A/B test cleanup. Efficiently identify winners, merge variants into baseline entries, and publish results in one click."
url: "https://www.contentstack.com/docs/developers/marketplace-apps/clear-winner"
product: "Contentstack"
doc_type: "guide"
audience:
  - developers
  - admins
version: "current"
last_updated: "2026-04-30"
---

# Clearwinner App Installation Guide

The **Clearwinner** Marketplace app in Contentstack automates the post-test cleanup process for [A/B test](/docs/personalize/create-ab-test-experience) experiences run through Contentstack Personalize.

When an A/B test concludes, the traditional process requires manually merging variant changes into baseline entries, publishing updates, and archiving the test. ClearWinner eliminates this manual effort by identifying winning variants and executing a single-click merge and publish workflow.

## Key Benefits

*   **Efficiency**: Automatically merges winning content into baseline entries in the background.
*   **Accuracy**: Reduces human error by automating data cleanup and variant deletion.
*   **Streamlined Workflow**: Publishes updated entries to your live environment and archives the test in a single step.

## Prerequisites

*   [Contentstack account](https://www.contentstack.com/login/)
*   Access to the Contentstack Organization/Stack as the Owner/Admin
*   At least one active A/B test experience set up in Contentstack Personalize

## Install and Configure Clearwinner in Marketplace

To install the app in Contentstack, log in to your [Contentstack account](https://app.contentstack.com/) and follow the steps below:

1.  Navigate to the **App Switcher** icon in the top-right corner and click **Marketplace**.  
    ![Contentstack\_Marketplace\_Apswitcher.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt467504401942b0da/69f3223561d51ac98ddbf462/Contentstack_Marketplace_Apswitcher.png)  
    
2.  Click **Apps** from the left panel.
3.  Within the Marketplace, you can see the available apps. Hover over the **Clearwinner** app and click **Install**.
4.  In the pop-up window, select the stack where you want to install the app, accept the **Terms of Service**, and click **Install**.
5.  On the **App Configuration** screen, click **Authorize** to allow Clearwinner to access your Contentstack data via the OAuth flow.  
    ![Contentstack\_Marketplace\_ClearWinner\_Authorize.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt6d73bda285b5336b/69f32235a297c802248365df/Contentstack_Marketplace_ClearWinner_Authorize.png)  
    
6.  On the **UI Locations** tab, you can see the predefined app location ([Stack Dashboard Location](/docs/developers/developer-hub/dashboard-location)). You can use the toggle button corresponding to enable or disable it based on your requirements.  
    ![Contentstack\_Marketplace\_ClearWinner\_App\_locations.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/bltb1ee7b53a21abbfc/69f322358a644d0113a6d6a1/Contentstack_Marketplace_ClearWinner_App_locations.png)  
    
    **Additional Resource:**
    
    *   For more information on UI location, please refer to the [Installed Apps](/docs/developers/marketplace-platform-guides/installed-apps#view-edit-configuration-ui-locations-and-webhook) guide.
    

**Note:** Authorization is performed once per organization. Once authorized, ClearWinner is accessible to all users in the organization and operates with the permissions of the authorizing user. There are no per-user permission controls at this time.

## Use Clearwinner within your Stack

To use the Clearwinner app, log in to your [Contentstack account](https://www.contentstack.com/login/) and follow the steps below:

1.  Navigate to the **App Switcher** icon in the top-right corner and click **Clearwinner**.  
    ![Contentstack\_Marketplace\_ClearWinner\_.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt5f60a4c221a0f837/69f322358c2ce16bf7258b4b/Contentstack_Marketplace_ClearWinner_.png)  
    
2.  Use the dropdown menu to choose the **Personalize project** containing the A/B tests you want to manage.  
    ![Contentstack\_Marketplace\_ClearWinner\_Personalise\_Project.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt4d5a72152baf191e/69f32236c58f745b67258043/Contentstack_Marketplace_ClearWinner_Personalise_Project.png)
3.  Review your A/B tests across the following three tabs on the dashboard:
    
    *   **Ready to merge**: Tests where Personalize has identified a winning variant.
    *   **Pending A/B tests**: Tests that are still running with insufficient data to determine a winner.
    *   **Merged A/B tests**: A read-only historical log of tests already processed by Clearwinner.
    
    For each test in the **Ready to merge** tab, the dashboard displays the test name, status, leading variant with its statistical confidence level, and the last modified date.
    
    Clearwinner surfaces the statistical confidence levels reported by Contentstack Personalize:
    
    *   **Has\_Won**: The variant has reached full statistical significance (strongest signal).
    *   **Leading Significantly:** The variant is substantially ahead but below the final threshold.
    *   **Leading**: The margin is currently ahead but not yet statistically significant.  
        ![Contentstack\_Marketplace\_ClearWinner\_Leading\_Variant\_Status.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blta75165de981828b1/69f32236cc157b3f0b21b317/Contentstack_Marketplace_ClearWinner_Leading_Variant_Status.png)
4.  Select one or more tests on the **Ready to merge** tab using the checkboxes and click **Review and Merge**.
    
    **Note:**
    
    *   Only one merge job can run at a time. If a merge is already in progress, an error will be displayed and you cannot start a new job until the current one completes.
    
    ![Contentstack\_Marketplace\_ClearWinner\_Merge.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt36bfe5e6f01e7f23/69f324b8700ea23a8258bd15/Contentstack_Marketplace_ClearWinner_Merge.png)
5.  Review the summary of tests, winning variants, and updated entries, then click **Merge**.  
    ![Contentstack\_Marketplace\_ClearWinner\_Merge\_Test.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt4ae3d00cc4cd4159/69f32236f2be51ef00864e95/Contentstack_Marketplace_ClearWinner_Merge_Test.png)  
    
6.  A final confirmation dialog will appear, stating that the following actions will occur:
    *   Winning variant content changes will be merged into baseline entries.
    *   Updated entries will be published to the live environment.
    *   The A/B test will be archived in Personalize.
    *   All variant entries and variant groups will be permanently deleted.
7.  In the final confirmation dialog, click **Confirm**.
    
    **Warning:** This action is irreversible. The variant data will be permanently deleted once the merge completes.  
    
    ![Contentstack\_Marketplace\_ClearWinner\_Confirm\_Merge.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blte4d38eef21d10097/69f32236b1ca70078f756204/Contentstack_Marketplace_ClearWinner_Confirm_Merge.png)
8.  Monitor the merge job's live progress via the indicator. You may navigate away; the background process will continue.
    
    **Note:**
    
    *   Entries are merged one at a time. For tests with a large number of entries, the merge job may take several minutes.
    
9.  Verify completed merges in the **Merged A/B tests** tab, which provides a read-only record including:
    *   Test name and description
    *   The merged winning variant
    *   Number of entries updated
    *   Timestamp of the merge  
        ![Contentstack\_Marketplace\_ClearWinner\_Merged\_A:B\_Tests.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt88e918a9366a9f4a/69f322368a644d1d49a6d6a5/Contentstack_Marketplace_ClearWinner_Merged_A_B_Tests.png)

## Limitations

*   **Sequential Entry Processing**: Entries are merged one at a time. Tests with many variant entries will take longer to complete.
*   **Shared Authorization**: Once authorized, the app is available to all users in the organization and operates with the permissions of the user who performed the authorization.
*   **One Merge Job at a Time**: Only one merge job can run per project at a time. Attempting to start a second job while one is in progress will result in an error.

## Re-authorization

If you encounter an authorization error, navigate to **Settings > Apps > Clearwinner > App Configuration** and click **Authorize** again to refresh the OAuth token.