> ## Documentation Index
> Fetch the complete documentation index at: https://launchdarkly-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Starting and stopping experiment iterations

> This topic explains how to start recording an experiment iteration and stop the experiment iteration when you're finished.

> For the complete documentation index, see [llms.txt](/llms.txt). For the full documentation snapshot, see [llms-full.txt](/llms-full.txt).

## Overview

This topic explains how to start recording an experiment iteration and stop the experiment iteration when you're finished. To learn more about running experiments, read [Managing experiments](/home/experimentation/manage).

## Start experiment iterations

After you create an experiment and toggle on the flag, you can start an experiment iteration in one or more environments.

To start an experiment iteration:

1. Navigate to the **Experiments** list.
2. Click on the environment section containing the experiment you want to start.
   * If the environment you need isn't visible, click the **+** next to the list of environment sections. Search for the environment you want, and select it from the list.

<Frame caption="The environment selection menu.">
  ![The environment selection menu.](https://files.buildwithfern.com/https://launchdarkly.docs.buildwithfern.com/docs/87c56af71df70f2fd4d97edb064cc3baab083b0819ca856dda0ee7f9f96af984/assets/images/auto/environment-selection.auto.png)
</Frame>

3. Click on the name of the experiment you want to start an iteration for. The **Design** tab appears.
4. Click **Start**.
5. Repeat steps 1-4 for each environment you want to start an iteration in.

<Frame caption="An experiment with the &#x22;Start&#x22; button called out.">
  ![An experiment with the "Start" button called out.](https://files.buildwithfern.com/https://launchdarkly.docs.buildwithfern.com/docs/f1d79f9d5fb317bac0da370cfc05c9bcbe2e8101b4f87fe2e294ac914729aaad/assets/images/auto/experiment-details-start.auto.png)
</Frame>

Experiment iterations allow you to record experiments in individual blocks of time. To ensure accurate experiment results, when you make changes that impact an experiment, LaunchDarkly starts a new iteration of the experiment.

When you start an iteration of an experiment, LaunchDarkly sends the maintainer and anyone following the experiment an email, an in-app notification, and, if you have the Slack app integration configured, a Slack notification.

<Card icon="link">
  You can also use the REST API: [Create iteration](/api-reference/experiments/create-iteration)
</Card>

## Stop experiment iterations

If you need to make changes to your experiment, you can stop your experiment iteration.

<Note title="Restarting an experiment reshuffles traffic">
  If you stop an experiment iteration, and then later start a new iteration, LaunchDarkly reshuffles traffic into new variations. To learn more, read [Variation reassignment](/home/experimentation/carryover).
</Note>

To stop an experiment iteration:

1. Navigate to the experiment's **Results** tab.
2. Click **Stop**. The "Ship" menu appears.

<Frame caption="An experiment with the &#x22;Stop&#x22; button called out.">
  ![An experiment with the "Stop" button called out.](https://files.buildwithfern.com/https://launchdarkly.docs.buildwithfern.com/docs/3a2f062656c8306917548efbefe3269ed79b3c44008716dc359b12d064b2405c/assets/images/auto/experiment-stop.auto.png)
</Frame>

3. Select the winning variation to ship to all contexts that match the flag's targeting rule. A "Stop experiment" dialog appears.
4. Enter a **Reason for stopping**.
5. Click **Stop experiment**.

After you stop an experiment iteration, the variation you chose in step 4 is served to all targets that match the experiment audience targeting rule. The flag's **Targeting** tab updates to reflect this.

You can stop an experiment iteration at any time. Just like starting an iteration, stopping an iteration only impacts the experiment in one environment. If you wish to stop collecting data from every instance of an experiment, you must stop each experiment in each environment individually.

When you stop recording an experiment, LaunchDarkly ends the iteration and stops collecting data about user behavior for that experiment. The data collected for that iteration is available on the experiment's **Results** tab.

When you stop an iteration of an experiment, LaunchDarkly sends the maintainer and anyone following the experiment an email, an in-app notification, and, if you have the [Slack app integration](/integrations/slack) configured, a Slack notification. To update your notification preferences, click the **bell** icon at the bottom of the left sidenav and select [Manage notification settings](/home/account/profile#update-your-notification-settings).

Stopping an experiment does not delete the experiment. Stopping an experiment lets you retain the results and data the experiment has already collected.

<Card icon="link">
  You can also use the REST API: [Patch experiment](/api-reference/experiments/patch-experiment)
</Card>
