> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/en/features/compliance/library/frameworks/import.md).

# Dastra import and templates

Create a framework from a Dastra template or import it from a JSON or Excel file.

In **Compliance** > **Library** > **Frameworks**, click **Create a framework**. The dialog offers three methods:

{% columns %}
{% column %}

* **Built-in template**: start from a template of the Dastra library (see below)
* **Personalized**: create a blank framework (see [Create a custom framework](https://doc.dastra.eu/en/features/compliance/library/frameworks/custom.md)). This method depends on your plan
* **Import a framework**: send a JSON or Excel file (see below)

From the same page, you can also view the **details of an existing framework**.
{% endcolumn %}

{% column %}

<div align="center"><img src="https://2697025545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-1972196547%2Fuploads%2Fgit-blob-f0a9621dd92971f046207011b33b00b924a829e8%2Fimage-426.png?alt=media" alt="create framework options"></div>
{% endcolumn %}
{% endcolumns %}

***

## Create a framework from a template

### Benefits of starting from a template

Importing a framework from a template makes it possible to **save time** and to rely on a framework that is already structured and compliant with regulatory or sector-specific best practices.

The templates offered by Dastra include:

* The structure of the chapters
* The associated requirements
* The controls
* The related risks and threats

They can then be **customized** to fit your context.

***

### Steps to import a template

{% columns %}
{% column %}

* Click on **Create a framework**
* Select **Built-in template**
* Access the Dastra template library
* Search a template by name, then set:
  * the **Choose the library source** filter (**Dastra default library** by default)
  * the language
  * the display mode of the results
* Select the desired template
* View the **framework details**:
  * Number of requirements
  * Controls
  * Risks
  * Threats
  * Functional description
* Confirm the import\
  → The framework is added to your Library and becomes **editable**.
  {% endcolumn %}

{% column %}

<figure><img src="https://2697025545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-1972196547%2Fuploads%2Fgit-blob-8e8d915c7cecd49d7f1dd81efa5ac5351f926f7c%2Fcompliance-framework-import-template-1.png?alt=media" alt="Create a framework dialog with the template library, the library source and the language"><figcaption></figcaption></figure>

<figure><img src="https://2697025545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-1972196547%2Fuploads%2Fgit-blob-ebbbafad6be3ccf90573e48ff542b4779b34d195%2Fimage-429.png?alt=media" alt="Details of a framework template with the number of requirements, controls, risks and threats"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% hint style="warning" %}
Creating a new framework consumes a **framework credit** on your account. When the quota is reached, you can still view the details of a template, but you cannot import it until you free up space or increase your quota.
{% endhint %}

Later versions of the framework (created, imported or generated by an update from the source referential) do not consume an additional credit.

***

## Import a framework from a file

You can import a framework that you prepared or exported from Dastra. This method requires the import right on the library and an available framework credit.

1. Click **Create a framework**, then **Import a framework**. If the library is empty, the **Import a framework** button is also offered directly.
2. Choose the format:
   * **JSON**: import your framework in .json;
   * **Complex excel workbook**: import your framework using an excel workbook composed of several sheets.
3. For the Excel workbook, click **Download the file template** to get the model workbook, which the import uses to recognize the data. Turn on **Use native column names or reports (recommended for importing data)** if your file uses the native column names.
4. Send your file (one at a time).
5. Dastra first shows a simulation: no data is modified. The table indicates, for each item, whether it will be **Created**, **Updated**, **Ignored** or **Simulated**, with the totals. Check it, then click **Validate** to run the final import.

The import creates the framework and all the items it contains in your library.

<figure><img src="https://2697025545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-1972196547%2Fuploads%2Fgit-blob-54b563e6c4effe3d0137cee60cfcd77bb6706de7%2Fcompliance-framework-import-file-1.png?alt=media" alt="Framework import dialog for an Excel workbook with the file template to download and the native columns option"><figcaption></figcaption></figure>

***

## Result after import

{% columns %}
{% column %}

<figure><img src="https://2697025545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-1972196547%2Fuploads%2Fgit-blob-df82b345af2206e87fc226b26d8f5fb98cce9420%2Fimage-447.png?alt=media" alt="Preview of the items that will be created when importing the framework"><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
You will then be able to check the elements before creation.

All the objects contained in your framework will be created in your library.
{% endcolumn %}
{% endcolumns %}

Once imported, the framework:

* Is available in the library
* Can be enriched or adapted
* Serves as a basis for:
  * **Compliance projects**
  * The assessment of controls
  * Risk management

***

## Updating from the source referential

When a newer version of the original template is available, the framework card displays the **Update available** badge and the framework page displays the banner *A newer version of the source referential is available* with the **update** link.

This link opens a preview of the changes (controls, tests, risk scenarios and threats). Once you validate, a published version of the framework is created from the source and becomes the current version; earlier versions and the projects that use them are not changed. See [Framework versions](https://doc.dastra.eu/en/features/compliance/library/frameworks/versions.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 by asking a question.

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

```
GET https://doc.dastra.eu/en/features/compliance/library/frameworks/import.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.
