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

# Domains Management

> Managing domains with the Domain Library

## The Domain Library

The domain library lives at `/shepherd/domains/`. The library is where users can view the current status of each domain and check out a domain for a project.

## Adding Domains

Domains can be added to the library one at a time or loaded en masse from a csv file.

<Tabs>
  <Tab title="Add One Domain">
    To add just one domain name to the library, click the **Domain Library** tab on the menu bar and **Add New Domain**. This opens the domain form for documenting and submitting a single domain name.

    You may not know the latest health information for the domain. You can set the domain to **Healthy** as a default value and leave categories blank.

    <Frame>
      <img src="https://mintcdn.com/specterops-2/JdAhGDWkEHwQXoje/images/features/image-26.avif?fit=max&auto=format&n=JdAhGDWkEHwQXoje&q=85&s=bf122e06f0b7a0a6d7f6ffcb94b04a6a" alt="" width="800" height="883" data-path="images/features/image-26.avif" />
    </Frame>
  </Tab>

  <Tab title="Upload Domains">
    To bulk add servers to the library, visit the admin panel and navigate to the **Domains** model. Click the **Import** button and follow the on-screen instructions.

    You can upload csv, xls, xlsx, tsv, json, and yaml files. Select the matching format from the dropdown menu.

    After a moment, the admin panel will display a diff screen and ask you to approve the changes.

    <Info>
      If a domain name already exists in the library, the import will update the existing record instead of discarding the data or duplicating the entry.
    </Info>

    <Check>
      The DomainCheck tool outputs a csv in this format if you want to preload health statuses with your domains. You may then optionally add the `note` column.

      [https://github.com/GhostManager/DomainCheck](https://github.com/GhostManager/DomainCheck)
    </Check>
  </Tab>
</Tabs>