# Exporting from Documents

With **Export All Files**, you can export a ZIP file containing all artifacts associated with a single document, including all related document source files and renditions. For example, you may work for an agency that needs to create a new version of a composite piece, which links to several other component assets within PromoMats. Using **Export All Files**, you can download the composite source file along with the source files for all related assets at once, rather than downloading and organizing hundreds of individual assets. **Export All Files** must be <a href="/en/gr/63091/">enabled by an Admin</a>.

## How to Export

To export all associated content and data for a given document, select **Export All Files** from the document's **Actions** menu. Vault displays a banner confirming your export and sends you a notification with a link to download the ZIP file.

You can **Export All Files** for any version of the document to get the specific artifacts associated with that document version.

## Export Package
The Export package consists of several elements which may vary depending on configuration and permissions.

### Artifacts

The exported ZIP file contains the following artifacts:

  * Document source file
  * All document renditions
  * PDF with Annotations file
  * Latest version of attachments
  * CSV of document fields (TXT file if localization is enabled)
  * CSV of the document audit trail for the document from which you performed the export

For related documents, the ZIP also contains:

  * Source files for all documents with custom relationships
  * Source files for all documents with standard relationships (excluding _CrossLink_ relationships)
  * Source files for all documents with _Based On_ relationships, including the source file for the _Original Source_ document
  * PDFs for all Linked Documents, including the anchor annotations specific to the document from which you performed the export

You can only export artifacts which you have the appropriate [permissions][1] to export. If you don't have permission to export all artifacts, Vault continues the export and notes the artifacts excluded in the export summary described below.

### Export Summary {#export-summary}

The ZIP file also contains an export summary CSV, including:

  * Date and time of export
  * Number of documents processed
  * Number of artifacts processed
  * Number of artifacts downloaded
  * Explanation of documents excluded from the export and why

### File & Folder Naming

Vault uses the following standards for naming files during export:

  * Document file names: Document name, plus the file type extension, for example, _REF-0023.docx_
  * Binder folder names: Document name, for example, _Compliance Pack CC-39_
  * Binder section folder names: Section name, for example, _References_

If an Admin has enabled the **Apply user-defined value as folder and file names in export** option, Vault uses the user-defined values in the _Export Folder Name_ field for binder sections names and the user-defined values in the _Export File Name_ document field for document file names in the exported ZIP file.

<div class="note-border alert-info">
  <div class="alert alert-info" role="alert">
    <div><i class="far fa-info-circle"></i></div>
    <div class="alert-text">
      <p><strong>Note</strong>: Vault does not include the following characters in the file name of an export: <strong>&lt;</strong>,<strong>&gt;</strong>,<strong>:</strong>,<strong>”“</strong>,<strong>/</strong>,<strong>\</strong>,<strong>|</strong>,<strong>?</strong>,<strong>*</strong></p>
    </div>
  </div>
</div>



## Limits
The following limits impact export results.

### Export Limits

  * If a Linked Document is a binder or video document, Vault excludes it from the export because there is no PDF.
  * If your document is related to binder, the export includes source files for each document in the binder.
  * If you **Export All Files** from a binder, your export includes all artifacts associated with each document in the binder.
  * You cannot **Export All Files** from a placeholder document.

### File Size Limits

By default, you cannot export more than 50,000 artifacts, and export ZIP files may not exceed 5GB. You'll see an error notification if a requested export exceeds either limit.

## Audit Trail

With **Export All Files**, Vault logs all artifact downloads in the audit trail of the document on which you are performing the export. For related document artifacts, Vault logs all downloads in the audit trails of the related documents. Vault also captures all downloads as download events in the <a href="/en/gr/42968/">_Document Usage Metrics_ object</a>.

## Related Permissions {#permissions}

The following permissions control the ability to export all files for a document:

<table class="wbord">
  <tr>
    <td>
      <strong>Type</strong>
    </td>
    <td>
      <strong>Permission</strong>
    </td>
    <td>
      <strong>Controls</strong>
    </td>
  </tr>
  <tr>
    <td>
      Security Profile
    </td>
    <td>
      Application: Documents: Download Document
    </td>
    <td>
      Ability to download document source files, and the <em>Large Size Asset</em> rendition type.
    </td>
  </tr>
  <tr>
    <td>
      Security Profile
    </td>
    <td>
      Application: Documents: Download Rendition
    </td>
    <td>
      Ability to include document renditions in the exported ZIP file.
    </td>
  </tr>
  <tr>
    <td>
      Security Profile
    </td>
    <td>
      Application: Audit Trail: Export
    </td>
    <td>
      Ability to include the audit trail in the exported ZIP file.
    </td>
  </tr>
  <tr>
    <td>
      Document Role
    </td>
    <td>
      Download Source
    </td>
    <td>
      Ability to download the source file and the <em>Large Size Asset</em> rendition type for a given document via export. This permission is required to run the <strong>Export All Files</strong> action.
    </td>
  </tr>
  <tr>
    <td>
      Document Role
    </td>
    <td>
      View Document
    </td>
    <td>
      Ability to view the document, run <strong>Export All Files</strong> action, and include attachments in the exported ZIP file. It is also required on related documents in order to download their source files, and Linked Documents in order to download the PDF with Annotations.
    </td>
  </tr>
  <tr>
    <td>
      Document Role
    </td>
    <td>
      View Content
    </td>
    <td>
      This permission is required on the document in order to download its source file. It is also required on related documents in order to download their source files, and Linked Documents in order to download the PDF with Annotations.
    </td>
  </tr>
</table>

 [1]: #permissions