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

# Project Settings

> Create and configure projects — metrics, repos, integrations, and team structure

**Nav:** Sidebar > Projects > Settings (per project) | **URL:** `/projects/<project_id>/settings`

Without clear project boundaries, experiments pile up in a flat list with no shared context. Teams lose track of which experiments belong to which goal, and leadership can't compare progress across workstreams.

Projects are the top-level organizational unit in Remyx. Each project groups related experiments around a shared goal and target metric, defining what your team is optimizing for and which tools are connected. This structure is what powers the [Projects](/platform/manage/projects) portfolio and the [Insights](/platform/experiments/insights) pattern detection.

***

## Creating a Project

There are two ways to create a project:

1. **From the project switcher:** Click **+ New project** in the switcher at the top of the sidebar.
2. **From the Projects page:** Click **+ New Project** on the [Projects](/platform/manage/projects) page (Manage > Projects in the sidebar).

Both routes open the same project creation wizard.

***

## Project Settings

Access settings by opening a project from the switcher and clicking **Settings** in the project page, or by clicking the **gear icon** on any project row in the [Projects](/platform/manage/projects) page.

### Description

Free-text description of the project's goal. Visible in the Projects portfolio row and at the top of the Outcomes dashboard.

### Allowed Metrics

Define the target metrics available for experiments in this project. These appear as dropdown options when creating or updating experiments.

| Action              | How                                                                           |
| ------------------- | ----------------------------------------------------------------------------- |
| **Add a metric**    | Type a metric name (e.g., "resolution rate", "conversion rate") and click Add |
| **Remove a metric** | Click the X next to an existing metric                                        |

<Tip>
  Keep metrics business-oriented: "resolution rate", "7-day retention", "CSAT score". These are what appear on the experiment timeline chart and in the Projects sparklines.
</Tip>

### GitHub Repos

Link one or more GitHub repositories to this project. Linked repos are:

* Used by the [launch context builder](/platform/experiments/outcomes#origin-section) to fetch file trees for implementation plans
* Available as target repo options when creating experiments
* Monitored for PR status updates via webhooks

| Action            | How                                     |
| ----------------- | --------------------------------------- |
| **Add a repo**    | Enter `owner/repo` format and click Add |
| **Remove a repo** | Click the X next to an existing repo    |

<Note>
  Requires an active [GitHub connection](/platform/manage/connectors#github) at the Connectors page.
</Note>

### Linear Project

Link a Linear project for automatic ticket creation:

| Field            | Description                |
| ---------------- | -------------------------- |
| **Project ID**   | Linear project UUID        |
| **Project Name** | Display name               |
| **Project URL**  | Link to the Linear project |

When set, every new experiment in this project automatically creates a linked Linear issue.

### Jira Project

Same as Linear — link a Jira project for automatic issue creation. Requires an active [Jira connection](/platform/manage/connectors#jira).

### Data Sources

Configure external data sources relevant to this project (e.g., dataset repositories, data pipelines). These appear as context in experiment detail views.

### A/B Testing Provider

Select and configure your A/B testing platform:

| Provider         | Configuration               |
| ---------------- | --------------------------- |
| **Statsig**      | Console API key             |
| **LaunchDarkly** | SDK key                     |
| **Split**        | API key                     |
| **Custom**       | Base URL and authentication |

<Info>
  A/B testing integration is in preview. Configuration is stored but automated result pulling is coming soon.
</Info>

### MLflow / Experiment Tracking

Link an MLflow tracking server or other experiment tracking tool. Experiments can reference specific tracking runs in their Resources sidebar.

***

## Deleting a Project

At the bottom of Project Settings, click **Delete Project**. A confirmation modal appears. Deleting a project does not delete its experiments. They remain accessible but are no longer grouped under the project.

***

## Related

<CardGroup cols={2}>
  <Card title="Projects" icon="grid-2" href="/platform/manage/projects">
    Portfolio view of all projects
  </Card>

  <Card title="Connectors" icon="link" href="/platform/manage/connectors">
    Connect GitHub, Linear, Jira before linking to projects
  </Card>

  <Card title="Account & API Keys" icon="user" href="/platform/admin/account">
    Manage profile, teams, and API access
  </Card>
</CardGroup>