> For the complete documentation index, see [llms.txt](https://compassly.gitbook.io/compassly-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://compassly.gitbook.io/compassly-docs/core-modules/program-library/subdomains/add-new-subdomain.md).

# Add New Subdomain

**Page type:** Task guide\
**Status:** Draft (Noah Edit)\
**Owner:** Documentation Team\
**Last verified:** 2026-04-02 (Noah Edit: 2026-04-23)\
**Audience:** Super Admin

## What This Section Covers

This material covers how to create a new Subdomain in the Program Library.

## Before You Start

* You must have permission "View subdomain list".
* You must have permission "Add new subdomain".
* Confirm that the Subdomain you want to create does not already exist in the Program Library.

## Where To Start

1. Sign in to Compassly.
2. In the left navigation menu, select ***Program Library***.
3. In the left navigation menu, select ***Subdomains*** from the dropdown menu under ***Program Library***.

## Available Actions

1. **Add a new Subdomain to the Program Library.**
   * Click on the "+" button in the upper right corner of the page.
   * A small dropdown menu should appear. Select the option "Add new subdomain" to continue.

![](/files/uL2Hg4dUO8h87pHNe6pw)\
*Figure 1. Subdomain List page with emphasis on create subdomain navigation.*

* You should be directed to a new page titled "Add new subdomain". The only required input is a text field is *Subdomain* (No text length or character limits).

![](/files/GOl2H6oMZqxRWJO4yRz1)\
*Figure 2. Add new subdomain page overview.*

* After all input fields have been filled out, click the "Apply" button to save your new Domain. A notification should pop up in the bottom left corner of the page to confirm your success.

![](/files/TxbsL1ubHtF3343mFY0E)\
*Figure 3. Success notification for creating a new Subdomain.*

## Role Differences

* ***Super Admin:*** Will be able to add new Subdomains to the Program Library.
* ***Admin / Supervisor / Clinician / Basic:*** Does not have access to create new Subdomains for the Program Library.

## Summary Of Section

**Upon reviewing this material, you should be able to:**

* Add a new Subdomain to the Program Library.

## Related Guides

* [View Subdomain List](/compassly-docs/core-modules/program-library/subdomains/view-subdomain-list.md)
* [View Subdomain Details](/compassly-docs/core-modules/program-library/subdomains/view-subdomain-details.md)
* [Edit Subdomain](/compassly-docs/core-modules/program-library/subdomains/edit-subdomain.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://compassly.gitbook.io/compassly-docs/core-modules/program-library/subdomains/add-new-subdomain.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.