> 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/domains/edit-domain.md). # Edit Domain **Page Type:** Task Guide\ **Status:** Draft (Noah Edit)\ **Owner:** Compassly Documentation Team\ **Last Verified:** 2026-04-02 (Noah Edit: 2026-04-23)\ **Audience:** Super Admin ## What This Section Covers This material covers how to update an existing Domain in the Program Library. ## Before You Start * You must have permission "View domain list". * You must have permission "Edit domain". * Depending on your role, you may see only be able to acces the View Details page OR the Edit Details page. ## Where To Start 1. Sign in to Compassly. 2. In the left navigation menu, select ***Program Library***. 3. In the left navigation menu, select ***Domains*** from the dropdown menu under ***Program Library***. ## Available Actions 1. **Open a Domain in Edit mode.** * You may want to use the filters covered in "View Domain List" guide to narrow your list data. * You can either select the item by clicking on the item's row in the list, or by opening the Action dropdown menu (click the three dots on the right under the Action column) and selecting "Edit Domain". ![](/files/mZcby0IXpdMbaSPrE5fD)\ *Figure 1. Domain list page with emphasis on edit navigation.* 2. **Alter a *****Domain name*****.** * Once on the "Edit domain" page, you should see a standard text field with the name of the Domain that you are attempting to edit. Simply click into the field in order to start editing. There are no character length or type limits. The only restriction is that there has to be something in the field in order to save. ![](/files/X8FKhc6qGyboZW8e04sT)\ *Figure 1. Domain Edit page overview with emphasis on edit options.* 3. **Alter/add/remove a Domain Icon.** * Next to the *Domain name* text field, you will either see a small image, or an icon that looks like a landscape with a plus sign in the corner. Click on that to open a small dropdown menu, and you should see options "Upload new icon", "Download", and "Delete". If there is already an icon associated with the Domain, you should be able to click on "Download" and "Delete". If not, Then the only available option should be "Upload new icon". Click on the "Upload new icon" option and it should open the file explorer on your computer, where you can navigate to and select a image to upload as an icon. One you have selected an image, a success notifcation should appear in the bottom left corner of your screen. ![](/files/JNIq7UmqxIdbrj8yvZ1T) ![](/files/kRvnhHG8OTUvWft3DkM4)\ *Figure 2 - 3. Icon dropdown menuy and success notification for uploading an icon.* 4. **Save Changes to Domain.** * Once all your alterations are complete, select the "Update" button at the bottom of the form to save your changes. A success notifcation should appear at the bottom left corner of your screen. ![](/files/NlkJFCiBPq4tkGokwW8G)\ *Figure 4. Success notification for saving changes to a Domain.* 5. **Use the "Cancel" button to exit back to the Domain List without saving.** * If a change is made to the Domain details, clicking the "Cancel" button will generate a dialog box to confirm that you want to back out without saving your changes. * Hitting the cancel button when no changes have been made will also not trigger the dialog box for confirmation. ![](/files/WrTasFHRtZP4UV67QhVS)\ *Figure 5. The dialog box that pops up when you try to back out of an edit without saving changes.* ## Role Differences * ***Super Admin:*** Will be able to edit details for Domains. * ***Admin / Supervisor / Clinician / Basic:*** Does not have access to edit Domains. ## Summary Of Section **Upon reviewing this material, you should be able to:** * Navigate to the Edit page for Domains * Alter the *Domain name* field * Alter the icon of a Domain * Save changes to a Domain * Back out of editing a Domain without saving changes using the "Cancel" button ## Related Guides * [How to View Domain Details](/compassly-docs/core-modules/program-library/domains/view-domain-details.md) * [How to View the Domains Program Library](/compassly-docs/core-modules/program-library/domains/view-domain-list.md) * [How to Delete a Domain](/compassly-docs/core-modules/program-library/domains/delete-domain.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/domains/edit-domain.md?ask=&goal= ``` `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.