
## Asset export (advanced)

URL: https://docs.atlan.com/product/capabilities/discovery/references/asset-export-advanced

> Complete configuration reference for the Asset export (advanced) app, including output destinations, filter logic, and export attribute selection.

<!--vale off-->

# Asset export (advanced) 

<!--vale on-->

The **Asset export (advanced)** app exports a filtered set of assets from Atlan to a destination you specify. It translates the filter criteria you define into an asset query, retrieves the matching assets, generates a CSV file, and delivers it to the selected output.

This reference provides complete configuration details for the app, including output destination options, filter logic, asset filters, custom metadata filters, and export attribute selection.

## Access

The **Asset export (advanced)** app isn't enabled by default. To use this app, contact [Atlan support](https://docs.atlan.com/support/submit-request) and request it be added to your tenant. Once enabled, the app can be set up and run by admins or users with workflow permissions.

## Select output destination

This section defines where the exported CSV file is delivered. Select one output type per workflow run.

### File name

The name of the file generated by the workflow. The `.csv` extension is automatically appended and doesn't need to be included. Leave blank to use the default file name.

:::info Not applicable for all outputs
The **File name** field is ignored when **Google Sheet** or **CSV download** is selected as the output destination.
:::

### Email

Delivers the export as a CSV attachment to one or more email addresses.

#### Atlan API token

Required to generate dynamic filter dropdowns in the **Apply asset filters** and **Apply custom metadata filters** sections.

#### Email addresses

A comma-separated list of email addresses that receive the CSV export as an attachment.

#### Email subject (optional)

Subject line of the email sent by Atlan. If left blank, the default subject is used.

#### Email body (optional)

Body text of the email sent by Atlan. If left blank, the default body is used.

:::warning Attachment size limit
The maximum size for email attachments is 25 MB. If the generated file exceeds 25 MB, use another output destination such as **S3 bucket**, **GCS**, or **ADLS**.
:::

### S3 bucket

Delivers the export to a path in an Amazon S3 bucket.

#### Atlan API token

Required to generate dynamic filter dropdowns in the **Apply asset filters** and **Apply custom metadata filters** sections.

Use this option to upload the exported CSV to an Amazon S3 bucket. You can authenticate using IAM user credentials or an IAM role. Object storage is recommended for larger exports, automated pipelines, or recurring runs where the destination bucket is managed outside Atlan.

For detailed information on configuring storage credentials, access methods, and required fields for each provider, see **[Object storage configuration for apps](https://docs.atlan.com/llms/platform/packages/object-storage-configuration/llms.txt)**.

:::info Cross-account IAM role
If you are using an IAM role for cross-account access, contact your Customer Success representative to set up the required cross-account bucket policy.
:::

### Google Sheet

Delivers the export directly into a Google Sheet worksheet.

#### Atlan API token

Required to generate dynamic filter dropdowns in the **Apply asset filters** and **Apply custom metadata filters** sections.

#### Google sheet key

The unique identifier of the target Google Sheet. See [How do I find my Google Sheet key?](https://developers.google.com/workspace/sheets/api/guides/concepts#spreadsheet-id)

#### Worksheet name

The name of the tab (worksheet) within the Google Sheet where the data is written. Also referred to as the sheet tab.

#### Service account JSON

A Google service account key in JSON format. The service account must be granted edit access to the target spreadsheet.

### CSV download

Generates a CSV file that can be downloaded directly from the Atlan UI.

#### Atlan API token

Required to generate dynamic filter dropdowns in the **Apply asset filters** and **Apply custom metadata filters** sections.

:::info File always zipped
When **CSV download** is selected, the exported file is always compressed, regardless of the **Zipped** setting in [Configure export attributes](#configure-export-attributes).
:::

### GCS

Delivers the export to a path in a Google Cloud Storage bucket.

#### Atlan API token

Required to generate dynamic filter dropdowns in the **Apply asset filters** and **Apply custom metadata filters** sections.

Use this option to upload the exported CSV to a Google Cloud Storage bucket. Object storage is recommended for larger exports, automated pipelines, or recurring runs where the destination bucket is managed outside Atlan.

For detailed information on configuring storage credentials, access methods, required permissions, and required fields, see **[Object storage configuration for apps](https://docs.atlan.com/llms/platform/packages/object-storage-configuration/llms.txt)**.

### ADLS

Delivers the export to a path in an Azure Data Lake Storage container.

#### Atlan API token

Required to generate dynamic filter dropdowns in the **Apply asset filters** and **Apply custom metadata filters** sections.

Use this option to upload the exported CSV to an Azure Data Lake Storage container. Object storage is recommended for larger exports, automated pipelines, or recurring runs.

For detailed information on configuring storage credentials, access methods, and required fields, see **[Object storage configuration for apps](https://docs.atlan.com/llms/platform/packages/object-storage-configuration/llms.txt)**.

## Set filter logic

This section controls how multiple filter conditions are combined and which additional attributes are included in the export.

### Filter combination mode

Defines how the conditions applied in [Apply asset filters](#apply-asset-filters) and [Apply custom metadata filters](#apply-custom-metadata-filters) are evaluated together.

- **Match all**: All filter conditions must be satisfied for an asset to be included. Equivalent to a logical AND across all active filters.
- **Match any**: At least one filter condition must be satisfied for an asset to be included. Equivalent to a logical OR across all active filters.

### Additional attributes

Specifies additional asset attributes to include as columns in the export file, beyond the predefined set.

:::info Relationship attributes not supported
The **Additional attributes** option doesn't support relationship attributes. Only scalar and enumerated attributes can be selected.
:::

### Export user-defined relationships

Controls whether user-defined relationships between assets are included in the export file.

- **Enabled**: Relationship data between assets defined by users is included.
- **Disabled**: User-defined relationship data is excluded from the export.

## Apply asset filters

This section defines which assets are included in the export. Each filter consists of an operator and a value. A filter is applied only when both the operator and value are provided.

:::info Exceptions: "Is empty" and "Isn't empty"
The **Is empty** and **Isn't empty** operators don't require a value. Any value provided for these operators is ignored.
:::

The following filters are available:

- Connector
- Connection
- Asset type
- Name
- Certificate
- Qualified name
- GUID
- Tag
- Domain
- Description
- Has lineage
- Announcement
- Owner user
- Owner group
- Is archived
- Has terms
- Asset (source) tag
- Created (in Atlan)
- Last updated (in Atlan)

## Apply custom metadata filters

This section enables filtering based on custom metadata attributes. Each filter consists of a custom metadata selector, an operator, and a value. A filter is applied only when both the operator and value are provided.

:::info Exceptions: "Is empty" and "Isn't empty"
The **Is empty** and **Isn't empty** operators don't require a value. Any value provided for these operators is ignored.
:::

:::tip Multiple values
If a custom metadata attribute supports multiple values, use comma-separated strings with the **Is one of** or **Isn't one of** operator to filter on multiple values simultaneously.
:::

## Configure export attributes

This section controls which attributes are exported and how the output file is structured.

### Importable

Controls whether the export is formatted for use as input to the **Asset Import** app.

- **Yes**: Ensures appropriate details are included in the output so that the file can be used directly with the [Asset Import](https://docs.atlan.com/llms/catalog/discovery/asset-import/llms.txt) app. Exposes an additional **Timestamp format** option:
 - **Unix**: Exports timestamp attributes in Unix epoch format.
 - **ISO 8601**: Exports timestamp attributes in ISO 8601 format.
- **No** (default): Produces a business-friendly output with a fixed predefined set of columns.

### Column selection

### Fixed

When **Importable** is set to **No**, the following predefined columns are exported:

- Description
- Alias
- Usage queries (last 30 days)
- Usage users (last 30 days)
- User owners
- Group owners
- Linked terms
- Tags
- Certificate status
- Announcement
- Created by (in Atlan)
- Last updated by (in Atlan)
- Created (in Atlan)
- Last updated (in Atlan)
- Connection name
- Last queried
- Last updated (on source)
- Source updated by
- Readme
- Labels
- Links
- Category *
- Linked assets *
- Related terms *
- Business Graph *
- Parent category *
- Inputs *
- Outputs *
- All custom metadata

:::warning Conditional columns
Columns marked with * are included only under specific conditions:

- **Category**, **Linked assets**, and **Related terms** are exported only when **Atlan glossary term** is selected in the Asset type filter.
- **Business Graph** is exported only when **Atlan glossary term** or **Atlan glossary category** is selected in the Asset type filter.
- **Parent category** is exported only when **Atlan glossary category** is selected in the Asset type filter.
- **awsArn** is automatically included when the export contains at least one S3 bucket or S3 object asset.
- **Inputs** and **Outputs** are automatically included for process assets.
:::

### Dynamic

When **Dynamic** column selection is enabled, the columns to export are selected from a dropdown menu. Use this option to customize the output to specific asset attributes needed for your use case.

### Zipped

Controls whether the output file is compressed before delivery.

:::info Behavior by output type
- When **Google Sheet** is selected, this option is ignored.
- When **CSV download** is selected, the file is always compressed regardless of this setting.
:::

## See also

- [Export certified assets via email](https://docs.atlan.com/llms/catalog/discovery/export-certified-assets-by-email/llms.txt)
- [Asset export (basic) for enriched assets](https://docs.atlan.com/llms/catalog/discovery/asset-export-enriched/llms.txt)
- [Asset export (basic) for data products](https://docs.atlan.com/llms/governance/data-products/asset-export-basic/llms.txt)
- [Asset export (basic) for glossaries](https://docs.atlan.com/llms/governance/glossary/asset-export-basic/llms.txt)
- [Adoption export](https://docs.atlan.com/llms/catalog/discovery/adoption-export/llms.txt)
- [Asset Import](https://docs.atlan.com/llms/catalog/discovery/asset-import/llms.txt)

---
