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

# DNS records and project connection

> Manage DNS records and connect domains to projects or other runtime surfaces.

<Tip>
  **Live.** This area is documented as current, user-reliable behavior.
</Tip>

## Goal

Get from owning a domain to routing it where you actually need it.

## Prerequisites

* An existing domain in the portfolio

## Workflow

<Steps>
  <Step>
    Open the domain and inspect DNS controls.
  </Step>

  <Step>
    Add or review the records required for the target service.
  </Step>

  <Step>
    Use the project connection surface when the domain is meant for an application deployment.
  </Step>
</Steps>

## DNS management behavior

* Nameservers are editable separately from individual records.
* The UI distinguishes system-managed records from user-managed records.
* DNS changes are immediate in the control plane, but propagation still depends on registrar and DNS timing.

## Connecting a domain to a project

* Only active registered domains are available for project attachment.
* You can attach the apex domain or provide a subdomain like api or [www](http://www).
* Primary-domain selection is part of the connection flow.

## Expected result

<Check>
  The domain is configured to point at the intended StackShift-managed resource.
</Check>