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

# Import and Export Directory Listings via CSV

> Bulk import and export listings for your Directify directory using CSV — the fast way to populate a new directory or migrate existing data.

Directify provides powerful import and export capabilities to help you manage your listings in bulk. You can easily import listings from a CSV file and export your existing listings to CSV format.

## Importing Listings

To import listings into your directory:

1. Download the example CSV file to see the correct format
2. Prepare your CSV file with the following columns:

### Required Fields

* **name** - The listing name (required, max 255 characters)

### Optional Fields

* **description** - A brief description of the listing
* **content** - Detailed content/body text for the listing
* **url** - Website URL (max 255 characters)
* **phone\_number** - Contact phone number (max 255 characters)
* **email** - Contact email address (max 255 characters)
* **address** - Physical address (max 255 characters)
* **tags** - Comma separated list of tags (max 255 characters)
* **is\_no\_follow** - SEO nofollow setting (1/0, true/false, yes/no, y/n)
* **is\_featured** - Featured listing status (1/0, true/false, yes/no, y/n)
* **is\_active** - Published status (1/0, true/false, yes/no, y/n)
* **logo\_url** - URL to listing logo image (max 255 characters)
* **image\_url** - URL to listing cover image (max 255 characters)

<Note>
  **Important:** The boolean fields (is\_no\_follow, is\_featured, is\_active) should be set to 1 (true) or 0 (false) or y (yes) or n (no).
</Note>

### Import Settings

When importing, you can configure:

1. **Categories** - Assign imported listings to specific categories
2. **Update Existing** - Choose whether to update existing records
3. **Default Publishing** - Set whether imported listings should be published by default (this will override the is\_active field in the CSV file)

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/directify/images/import-demo.png" alt="Importing listings demo" />
</Frame>

<Note>
  Make sure your CSV file uses UTF-8 encoding for proper handling of special characters.
</Note>

### Import Results

After the import completes, you'll see a notification in the top-right corner with:

* Number of successfully imported articles
* Number of failed imports
* Option to download detailed results

The results file includes all attempted imports with status and error messages. To review failures:

1. Download the results CSV
2. Scroll right to see the "Error" column
3. Review specific error messages for each failed row

Common error messages include:

* Invalid title length
* Missing required fields
* Malformed dates
* Invalid URLs

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/directify/images/import-results-demo.png" alt="Import results notification and CSV" />
</Frame>

<Tip>
  Use the error messages to correct issues in your import file, then retry importing the failed rows.
</Tip>

## Exporting Listings

You can export all your listings to CSV format for backup or bulk editing purposes. The exported file will contain all the fields listed above.

<Warning>
  Large directories may take a few moments to export. The system will notify you once your export is ready for download.
</Warning>