Exporting Contacts

Contact exports let workspace owners and admins download contact data without waiting on the Contacts page. Leadpush prepares each CSV in the background, shows its progress in a shared export history, and sends an in-app notification when processing finishes or fails.

Before you start

• Confirm you are working in the correct workspace. Exports never include contacts from another workspace.
• You must be a workspace owner or admin to create, review, download, or delete exports.
• Apply any search, Provider, or Subscription filters before opening the export form.
• Decide whether you need every available attribute or only selected columns.
• A workspace can have up to two active exports at the same time.

Create a contact export

How filters are applied

Leadpush copies the committed table search and filters when you open the export form. Later changes to the Contacts table do not change an export that has already been queued.

An export can use:

• contact search
• one or more selected providers
• subscribed or unsubscribed status
• provider and subscription filters together

Table sorting, pagination, and checked rows are not included in the export definition. Contacts created after the export is submitted are also excluded.

Choose export attributes

All available attributes

The default option includes:

• contact ID
• email
• phone
• first name
• last name
• workspace custom fields
• subscription status
• provider
• created date
• updated date

The available columns are captured when the export is queued. Renaming or removing a custom field afterward does not change the column layout for that export.

Choose attributes

Use Choose attributes when the destination only needs part of the contact record. You can search the attribute list, select all attributes, clear the selection, or choose individual fields.

Selecting fewer columns can make large exports smaller and easier to work with.

Track export progress

Open Workspace Settings, then select Exports from the Data section. This page is shared by workspace owners and admins.

The export status moves through these stages:

• Queued means the request is waiting for an export worker.
• Preparing means Leadpush is finding matching contacts and dividing the work into batches.
• Processing shows how many contact rows have been processed and the current percentage.
• Finalizing means the CSV fragments are being assembled into the downloadable file.
• Completed means the file is ready.
• Failed means the export could not be generated.

The Exports page refreshes active rows automatically. You can leave the page while an export is running.

Download a completed CSV

When an export completes, Leadpush sends an in-app notification to the person who requested it.

The download link is valid for five minutes. If it expires, select Download CSV again to create another link while the export remains available.

Completed files remain available for up to 60 days after completion. After the expiration date, Leadpush removes the private file and export record automatically.

Delete an export

You can manually remove a completed or failed export before its expiration date.

Deleting a completed export removes its private CSV and export history record. Active exports cannot be deleted while they are queued, preparing, processing, or finalizing.

CSV value formatting

Leadpush generates standard CSV files that work with common spreadsheet and data tools.

• Empty values are exported as blank cells.
• Subscription values are exported as true or false.
• Dates use UTC ISO-8601 format.
• JSON fields use compact JSON.
• Commas, quotation marks, and line breaks are escaped using standard CSV rules.
• Text that could be interpreted as a spreadsheet formula is neutralized for safer opening in spreadsheet applications.

Troubleshooting

Related guides

• Contacts
• Importing Contacts
• Fields
• Data
• Creating Contacts