> 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/maladaptives/import-maladaptives.md).

# Import Maladaptives

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

## What This Section Covers

This material covers how to add multiple maladaptive behaviors to the Program Library by importing a file.

## Before You Start

* You must have permission "View maladaptive list".
* You must have permission "Import maladaptives".
* You need the current import template file before completing the import.
* Your spreadsheet must match the required format used by Compassly.

## Where To Start

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

## Available Actions

1. **Download an import template for uploading multiple Maladaptive Behaviors at once.**
   * In the uppermost right corner of the page, click on the button that has a download icon (an arrow pointing down towards what looks like a little tray). This should trigger a small dropdown menu. Select the option "Download import template", and the template should start downloading.

![](/files/0gbrCI3ytxN05ciGjhtm)\
*Figure 1. Example template download control.*

2. **Fill out the import template with all the Maladaptive Behaviors (and what details you can)**
   * Unless you deliberately downloaded your file to a different location, your import template should be available under the Downloads folder on you computer (this guide will not cover phone usage). Open the file and you should seem a table with instructional text in the top row, followed by a series of empty rows below it. Using the instructions provided, fill out as many Maladaptive Behaviors as you desire in these empty rows. If the number you are trying to import exceeds the number of rows with grey borders, no worries. You can add beyond the visible boundary point.
   * Keep in mind that trying to upload Maladaptive Behaviors with the same name as those that already exist in the Program Library will result in those maladaptives being omitted from the upload, even if the descriptions are different.

![](/files/Dh25XLAkuJRQzs0tUXYU)\
*Figure 2. Example of the import template.*

3. **Upload multiple Maladaptive Behaviors using the import template.**
   * Having filled out the downloaded import template, you can now import the file back into the Program Library. Assuming that you did not close your Compassly tab on your browser (if you did, see "How To Get There" section to return to the appropriate page) return to the Maladpative List and select the blue "Import maladaptives" button in the uppermost right corner of the page. This will open a dialog box prompting you to select the file for import. Either drag the file into the dash-line box, or click on the dash-line box to open your file explorer and navigate to the desired file. Once selected, the name of the file uploaded should be visible in the dash-line box, and the number of entries validation for import should appear below it. Ensure this number matches what you intended to upload (If not, you'll need to cancel the process, then go back into your import file to fix the issue), and then click the "upload" button to finalize the import. A notification will pop in the lower left corner of the page to confirm your results, or inform you of any duplicates that already exist.

![](/files/z0awfFbUjz3URZxolbf8)\
*Figure 4. Import button and resulting dialog box.*

![](/files/Hn7NpYE6a4BCTN3gPHl5)\
*Figure 5. Dialog box with file attached.*

![](/files/ZyV6ieXZJX3FPV7iXamC) ![](/files/CHTNJQDRW3MGaTW12Pq6) ![](/files/YkIZFrCutqL6k1cZ3j4l)\
*Figure 5. Notification of upload and download results.*

4. **Download select entries from the Maladaptives List based on filtering.**
   * In the uppermost right corner of the page, click on the button that has a download icon (an arrow pointing down towards what looks like a little tray). This should trigger a small dropdown menu. Select the option "Download report in XLSX" or "Download report in CSV" (whichever you prefer), and the file type will start downloading all the visible entries in the list based on current filter settings. If no filters are active, the entire Maladaptives List will be added to the file downloaded. A notification will display in the bottom left corner of the page informing you of the download, and its subsequent success.

## Role Differences

* ***Super Admin:*** Will be able to import multiple Maladaptives.
* ***Admin / Supervisor / Clinician / Basic:*** Does not have access to import multiple Maladaptives.

## Notes

* Older guides may describe a template or download behavior that has changed.
* If the import template is unavailable in the current UI, document that as both a guide gap and a product issue if the feature is expected.
* Use the current template each time when possible instead of reusing an older file format.

## Summary Of Section

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

* Download an upload template for Maladaptive Behaviors
* Fill out an import template for Maladaptive Behaviors
* Upload an import template for Maladaptive Behaviors
* Download a selective list of Maladaptive Behaviors in either an XLSX or CSV format

## Related Guides

* [View Maladaptive List](/compassly-docs/core-modules/program-library/maladaptives/view-maladaptive-list.md)
* [Add New Maladaptive](/compassly-docs/core-modules/program-library/maladaptives/add-new-maladaptive.md)
* [Edit Maladaptive](/compassly-docs/core-modules/program-library/maladaptives/edit-maladaptive.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/maladaptives/import-maladaptives.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.
