> For the complete documentation index, see [llms.txt](https://intuitem.gitbook.io/ciso-assistant/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://intuitem.gitbook.io/ciso-assistant/configuration/libraries/unload-or-delete-library.md).

# Unload or delete a library

Unload or delete a library from CISO Assistant

Unloading a library makes its content unavailable for use, but keeps the library in the catalog so you can load it again later. Deleting a library removes it from the catalog entirely. To use it again, you must re-import its Excel or YAML file into your instance.

## Unload a library

1. Open **Catalog > Libraries** and find the library you want to unload.
2. In the relevant row, click the <img src="https://629777851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCqFeU3oPCgDWkkR386NK%2Fuploads%2Fgit-blob-eeba78f0f8a22aace4490d0412d521b61a2977f3%2Funload_library_button.png?alt=media" alt="Document with a minus sign: Unload library" data-size="line"> button at the far right.

![Libraries page with the Unload library button highlighted for a custom library](https://629777851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCqFeU3oPCgDWkkR386NK%2Fuploads%2Fgit-blob-c3eeee68482d2b5e39334781052d45e72c13aa6f%2Funload_library.png?alt=media)

{% hint style="warning" %}
Only administrators can see the unload button. It is hidden while an audit uses the library's Framework, a risk assessment or business impact analysis uses its risk matrix, or an assessment uses its threats or controls based on its reference controls. Delete or change those objects first.

If a loaded Mapping library depends on this library, the button still appears, but unloading fails because the library is in use. Unload the Mapping library first.

If you only want to update the library, follow [Update a library](/ciso-assistant/configuration/libraries/update-library.md) instead.
{% endhint %}

## Delete a library

1. If the library is loaded, unload it first using the steps above.
2. In **Catalog > Libraries**, find the library you want to delete.
3. In the relevant row, click the <img src="https://629777851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCqFeU3oPCgDWkkR386NK%2Fuploads%2Fgit-blob-2cdda344f9a2a89fdcd629e4fb496a7c6ed419cf%2Fdelete_library_button.png?alt=media" alt="Trash can: Delete library" data-size="line"> button at the far right.

![Libraries page with the Delete button highlighted for an unloaded custom library](https://629777851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCqFeU3oPCgDWkkR386NK%2Fuploads%2Fgit-blob-fdb6b6d8a63427fa2f6da225b06ffff04d7fdfe5%2Fdelete_library.png?alt=media)

{% hint style="warning" %}
Libraries provided by CISO Assistant cannot be deleted from the catalog. If you want to import the library you are about to delete at a later time, keep a copy of its Excel or YAML file in a safe place before deleting it.
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://intuitem.gitbook.io/ciso-assistant/configuration/libraries/unload-or-delete-library.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
