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

# Configure Surface Reviews

> Learn how to add optional or required reviewers to all experiments on a surface.

export const HowToSchema = ({name, description, steps = []}) => {
  const schema = {
    "@context": "https://schema.org",
    "@type": "HowTo",
    name,
    description
  };
  if (steps.length > 0) {
    schema.step = steps.map((s, i) => ({
      "@type": "HowToStep",
      position: i + 1,
      name: typeof s === "string" ? s : s.name,
      text: typeof s === "string" ? s : s.text || s.name
    }));
  }
  return <script type="application/ld+json" dangerouslySetInnerHTML={{
    __html: JSON.stringify(schema)
  }} />;
};

<HowToSchema
  name="Configure Surface Reviews"
  description="Learn how to add optional or required reviewers to all experiments on a surface."
  steps={[
{
  name: "Go to the surface",
  text: "Go to Confidence and select Surfaces on the left sidebar, then select your surface.",
},
{ name: "Open Settings", text: "Click Settings." },
{
  name: "Edit Reviews",
  text: "In the Reviews section, click the edit button to open the review setup dialog.",
},
{
  name: "Select review type",
  text: "Choose a review option: - Don't add reviewers: Experimenters can add reviewers manually, but the surface won't add any by default. - Add required reviewers: At least one reviewer assigned by the surface must approve for experiments to launch. - Add optional reviewers: Add recommended reviewers to all experiments, but experiments can launch without explicit approval. Click Next to continue.",
},
{
  name: "Select reviewers",
  text: "Select users or groups as reviewers from the dropdown. Click Next to continue.",
},
{
  name: "Configure notifications (optional)",
  text: "Add a Slack channel or email address to centralize review request notifications. Reviewers always get personal notifications regardless of these settings. Click Save to apply your changes.",
},
]}
/>

Add optional or required reviewers to all experiments on a [surface](../surfaces/surface-settings#reviews). Required reviews block the launch of experiments until at least one of the required reviewers has approved the experiment setup.

## Configure Reviews

<Steps>
  <Step title="Go to the surface">
    Go to Confidence and select **Surfaces** on the left sidebar, then select your surface.
  </Step>

  <Step title="Open Settings">
    Click **Settings**.
  </Step>

  <Step title="Edit Reviews">
    In the **Reviews** section, click the edit button to open the review setup dialog.
  </Step>

  <Step title="Select review type">
    Choose a review option:

    * **Don't add reviewers**: Experimenters can add reviewers manually, but the surface won't add any by default.
    * **Add required reviewers**: At least one reviewer assigned by the surface must approve for experiments to launch.
    * **Add optional reviewers**: Add recommended reviewers to all experiments, but experiments can launch without explicit approval.

    Click **Next** to continue.
  </Step>

  <Step title="Select reviewers">
    Select users or groups as reviewers from the dropdown. Click **Next** to continue.
  </Step>

  <Step title="Configure notifications (optional)">
    Add a Slack channel or email address to centralize review request notifications. Reviewers always get personal notifications regardless of these settings. Click **Save** to apply your changes.
  </Step>
</Steps>

<Tip>
  Send all requests to a common Slack channel if there are several reviewers on a surface. This helps keep track of all the review requests and who is reviewing which experiment.
</Tip>

<Note>
  For reviewers to get personal Slack notifications about review requests, they need to [integrate their personal Slack account with Confidence](../notifications/introduction#integrate-your-slack-account-with-confidence).
</Note>

## Related Resources

<CardGroup cols={2}>
  <Card title="Surface Settings Reference" href="/docs/surfaces/surface-settings">
    Deep dive into surface configuration
  </Card>

  <Card title="Configure Notifications" href="/docs/how-to-guides/configure-surface-notifications">
    Set up Slack and email notifications
  </Card>

  <Card title="Experiment Workflow" href="/docs/experiments/workflows/abtests">
    Understand the experiment launch process
  </Card>

  <Card title="Create a Surface" href="/docs/how-to-guides/create-surface">
    Set up a new surface
  </Card>
</CardGroup>