Moving from another platform? Export your posts and subscriber list there first, then bring both into Paragraph.

Import your subscribers

Check your CSV

The file needs a column of email addresses. Extra columns (names, signup dates) are fine. CSV files can be up to 10 MB.

Ask Paragraph to import it

Open a chat, attach the CSV, and ask Paragraph to import the subscribers. The import runs in the background, so you can keep working.

Check the results

Imported subscribers appear in Subscribers with the "Imported" source. Compare the count with your old platform.

Only import people who signed up to hear from you. Purchased or scraped lists hurt deliverability and aren't allowed.

Import your articles

Paragraph accepts WordPress XML exports, Substack ZIP exports, and Paragraph JSON or CSV exports.

Preview the archive

Open Settings → article portability, choose the source, and upload the export file. Paragraph shows the articles it found before importing anything.

Start the import

Start the import from the preview. You can leave the page while it runs and come back to check progress.

Check the result

Titles, slugs, dates, tags, cover images, and publish state carry over when the source includes them. Running the same import again skips articles already imported. If some fail, download the failure report and retry just those.

Export and crosspost

Settings → article portability also lets you download your articles as JSON, and publish new entries from another site's RSS feed without importing its archive. To export subscribers, use Export CSV in Subscribers.

If your old site used a custom domain, point it at Paragraph so old links keep working. See custom domains.

Stuck on an odd export format? Email support@paragraph.com.

On this page