# Netlify

> Integrate Directus with Netlify to deploy your sites, track build progress, and manage frontend projects from within your Directus instance.

Integrate your Directus instance with Netlify to centrally deploy sites, track build progress, and manage multiple frontend projects — all from within Directus.

<callout icon="i-lucide-rocket">

**Quick Start**

1. **Enable Deployment module**: Enable the Deployment module in your Directus project settings
2. **Link your Netlify account**: Go to the Deployment module and enter your Netlify Personal Access Token
3. **Add sites**: Connect one or more Netlify sites to your Directus instance
4. **Deploy**: Trigger builds and track deployment progress from Directus

</callout>

<partial content="deployment-public-instance">



</partial>

## Getting Started

### Link Your Netlify Account

1. In Directus, go to **Settings**
2. Under **Modules**, enable the **Deployment** module
3. Open the Deployment module from the **primary navigation**
4. Select **Configure Netlify** to set up the integration

  - **Personal Access Token**: Your Netlify [personal access token](https://docs.netlify.com/api/get-started/#authentication)
  - **Account Slug (optional)**: Your [Account Slug](https://docs.netlify.com/manage/accounts-and-billing/team-management/overview/#access-or-modify-the-team-account-slug) to filter sites to a specific account. Leave empty to show all accessible sites
5. Click **Save** to connect and start adding sites

![Netlify configuration token](/img/netlify-configuration-1.png)

### Configure Sites

1. From the **Netlify Configuration** screen, choose **which Netlify sites** to manage from Directus
2. Click **Save** to add the selected sites
3. Return to integration settings anytime to add or remove sites

<callout icon="i-lucide-triangle-alert" color="warning">

**Removing Sites**<br />


Removing a site from the Netlify integration will permanently delete all deployment history for that site from Directus. This cannot be undone.

</callout>

![Netlify configuration sites](/img/netlify-configuration-2.png)

### View Your Sites

Once set up, your connected Netlify sites appear in the Deployment module. From here you can:

- See all connected sites at a glance
- Access deployment controls for each site
- Track deployment status and history

<callout icon="i-lucide-shield" color="info">

**Permissions**<br />


The Deployment module uses Directus native permissions to control access. See [Deployment Security](/guides/deployments/security) for details on configuring roles and access policies.

</callout>

![Netlify sites overview](/img/netlify-configuration-3.png)

## Documentation

**Working with Deployments →**

Trigger deployments, track build progress, and manage your frontend sites directly from Directus.
