> For the complete documentation index, see [llms.txt](https://docs.plextrac.com/plextrac-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.plextrac.com/plextrac-documentation/product-documentation/reports/import-plextrac-report.md).

# Importing a Report

PTRAC files (.ptrac) can be imported into PlexTrac for cross-team collaboration. For instance, a red team from one tenant can share with a blue team client with its own PlexTrac instance.

Reports can be imported either in the **Client** module or the **Reports** module. The instructions below are specific to the **Reports** module, assuming the user has an exported report in PTRAC format.

## Importing Permissions

Admins can configure the options to import files via the **Admin Dashboard** on the "Role Based Access" page. To do so, select a custom role and click the "Ability to import reports" button under Reports Permissions. A dialog box will appear with options to turn on/off the ability to import reports.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2F6iJa6mYGx4o8tvNhcr3U%2Fimage.png?alt=media&amp;token=174071f0-10f2-4e57-97b3-25c0b3a375ab" alt="" width="438"><figcaption></figcaption></figure></div>

## Importing a Report

<mark style="background-color:yellow;">Step 1:</mark> From the **Reports** module home page, click **Import Report**.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2Ff7fTufXZqB3FCglnkgmK%2Fimage.png?alt=media&amp;token=f2ddeb6d-669f-4f9a-a30d-4053a72ee575" alt="" width="563"><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 2:</mark> Select the client the report will be associated with from the pulldown menu on the modal.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FKytoUw0H0dcAqTC4JzdR%2Fimage.png?alt=media&amp;token=50722c80-c1a0-4c9b-a778-e2b3297b5026" alt="" width="401"><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 3:</mark> Drag the .ptrac file to the box provided or click the box and navigate to the file on the computer.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FcagF5hBITrLhvgg58qqx%2Fimage.png?alt=media&amp;token=cc98e021-8f4d-49e2-a9e3-97d0cc060712" alt="" width="398"><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 4:</mark> Click **Submit**.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FUHbNBVe5VS8BbYlWk5GC%2Fimage.png?alt=media&amp;token=5b9b99cd-39b8-4991-a58b-51e53c0b7877" alt="" width="396"><figcaption></figcaption></figure></div>

A progress bar will indicate the status; the upload may take a minute or two.

<div align="left"><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FCVBGaQbtxzkA5igb6TEa%2Fimage.png?alt=media&amp;token=efd56d2f-e01b-4106-af7c-faa22b56959e" alt="" width="433"></div>

When completed successfully, a confirmation message will appear.

<div align="left"><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FdNYLG95blMs1SSMddsQT%2Fimage.png?alt=media&amp;token=f97dfd8d-1414-4170-9e4e-209e866f2453" alt="" width="347"></div>


---

# 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://docs.plextrac.com/plextrac-documentation/product-documentation/reports/import-plextrac-report.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.
