> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.outpost.pub/llms.txt
> Use this file to discover all available pages before exploring further.

# Data Export

> Export member data, gift subscriptions, group subscriptions, institutional subscriptions, and physical addresses as CSV files.

The Data Export page lets you download CSV files of your member data, gift subscription records, group and institutional subscription records, and physical mailing addresses.

<Frame caption="Data Export page showing export cards for Gift Subscriptions, Members, and Physical Address">
  <img src="https://mintcdn.com/outpost-eb0cfbad/iGuIPa6vLXykjpr4/images/account/data-export.png?fit=max&auto=format&n=iGuIPa6vLXykjpr4&q=85&s=82c50fb87202ee9e7c556da5f9bfc50f" alt="Data Export page with Gift Subscriptions, Members filter dropdown, and Physical Address export cards" width="3110" height="1431" data-path="images/account/data-export.png" />
</Frame>

***

## Export types

### Members

Exports a CSV of members filtered by subscription status. Select a filter from the dropdown before exporting:

| Filter                | Description                                               |
| --------------------- | --------------------------------------------------------- |
| **Free**              | All free members (subscribed and unsubscribed to emails). |
| **Free Subscribed**   | Free members who are subscribed to emails.                |
| **Free Unsubscribed** | Free members who have unsubscribed from emails.           |
| **Paid**              | All paid subscribers.                                     |
| **All**               | Every member regardless of status.                        |

**CSV columns for member exports:**

| Column                  | Description                                          |
| ----------------------- | ---------------------------------------------------- |
| `ghost_id`              | The member's unique identifier.                      |
| `email`                 | Email address.                                       |
| `name`                  | Display name.                                        |
| `subscribed`            | Whether the member is subscribed to emails (1 or 0). |
| `created_at`            | Account creation date.                               |
| `status`                | Membership status (free, paid, etc.).                |
| `notes`                 | Internal notes about the member.                     |
| `labels`                | Comma-separated list of member labels.               |
| `custom_integration_id` | Custom integration identifier, if set.               |

For exports under approximately 4,000 members, the CSV downloads immediately. Larger exports are processed automatically, and you will receive an email when the file is ready to download.

### Gift Subscriptions

Exports a CSV of all gift subscription records, including recipient details (Ghost ID, email, name, internal note, labels, Stripe ID), giver details (Ghost ID, email, name, Stripe ID), and the gift subscription start and end dates. Runs as a background job — you'll get an email with the download when it's ready.

### Institutional Subscriptions

Exports a CSV of institutional subscription records. Columns: `group_name`, `pattern` (the JSON-encoded list of email-domain templates that defines the group), `member_ghost_id`, `member_email`, `member_labels`. Downloads instantly.

### Group Subscriptions

Exports a CSV of group subscription records. Columns: `subscription_name`, `is_public`, `member_ghost_id`, `member_email`, `member_labels`. Downloads instantly.

### Physical Address Export

Exports a CSV of member physical (mailing) addresses. Useful for sending printed newsletters, merchandise, or thank-you cards.

Physical address exports take a few moments to prepare because Outpost looks up the latest address on file for each member. You'll receive an email when the export is ready to download.

Columns: `tier_name`, `customer_id`, `name`, `email`, `address_line_1`, `address_line_2`, `city`, `state` (or `province`), `zip_code` (or `postal_code`, depending on country), `country`, `address_full`, `metadata`.

***

## Data privacy

Export files contain personal data (email addresses, names, physical addresses). Handle them in accordance with your GDPR/CCPA obligations and delete export files when they are no longer needed.

***

## Related features

<CardGroup cols={2}>
  <Card title="Members" icon="users" href="/features/members">
    View and manage the members whose data you're exporting.
  </Card>

  <Card title="Gift Subscriptions" icon="gift" href="/features/gift-subscriptions">
    Manage the gift subscriptions included in the gift export.
  </Card>

  <Card title="Group Subscriptions" icon="users-rectangle" href="/features/group-subscriptions">
    Manage group subscriptions and invited members.
  </Card>
</CardGroup>

***

## FAQ

<AccordionGroup>
  <Accordion title="What format are exports?">
    All exports are CSV files that can be opened in Excel, Google Sheets, or any spreadsheet application.
  </Accordion>

  <Accordion title="How long do large exports take?">
    Member exports over approximately 4,000 records and all physical address exports are processed in the background. Processing time depends on the number of records — physical address exports are slower because Outpost looks up each address individually. You'll receive an email when the file is ready.
  </Accordion>

  <Accordion title="Can I export data for a specific tier?">
    The Members export filters by subscription status (free, paid, all). For tier-specific exports, use the Physical Address Export which supports tier filtering, or filter the Members CSV in a spreadsheet after downloading.
  </Accordion>
</AccordionGroup>