---
title: Project Settings
description: "Configure your project's name, repository connection, custom domain, build triggers, and advanced settings from the Jamdesk dashboard project page."
---

Configure your project's display name, connected repository, branch, environment variables, custom domain, and danger zone options from the Settings page.

## Accessing Settings

1. Select your project from the dashboard
2. Click **Settings** in the sidebar

The settings page is split into sections for display, repository, team, configuration, and notifications.

<Frame>
  <img src="/images/dashboard/settings-general.webp" alt="Project settings showing Display Settings with project name and ID, and Git Repository configuration with branch selection and monorepo toggle" />
</Frame>

## General Settings

### Project Name

The display name shown in your dashboard. This doesn't affect your live documentation.

### Subdomain

Your default URL at `*.jamdesk.app`. To change:

1. Enter a new subdomain
2. Click **Save**
3. Wait for DNS propagation (usually instant)

<Note>
Subdomain changes don't break existing links—the old URL redirects to the new one.
</Note>

## Repository Settings

### Connected Repository

Shows your linked GitHub repository. To change repositories, you'll need to delete the project and create a new one.

### Branch

The Git branch that triggers builds. Typically `main` or `master`.

### Docs Path

For monorepo setups, specify the path to your `docs.json` (e.g., `packages/docs`).

Leave empty if `docs.json` is at the repository root.

## Build Settings

### Environment Variables

Set build-time variables for your documentation:

1. Click **Add Variable**
2. Enter the key and value
3. Click **Save**

Variables are available during build and can be referenced in your docs.

### Rebuild

Click **Rebuild** to trigger a fresh build without pushing to GitHub. Useful after changing settings.

## Custom Domain

Add your own domain in the **Domains** section. See [Custom Domains](/deploy/custom-domains) for setup instructions.

## Danger Zone

### Delete Project

Permanently deletes the project and all associated data:

- Build history
- Analytics data
- Custom domain configuration

<Warning>
This action cannot be undone. Consider transferring ownership if team members need continued access.
</Warning>

## Related Articles

<Columns cols={2}>
  <Card title="Team Members" icon="users" href="/help/projects/team-members">
    Manage project collaborators
  </Card>
  <Card title="Custom Domains" icon="globe" href="/deploy/custom-domains">
    Set up your own domain
  </Card>
</Columns>