Getting started
Import posts and subscribers
Bring your posts and subscribers to Paragraph from WordPress, Substack, or another platform.
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 your agent to import it
Open a chat, attach the CSV, and ask your agent 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 posts
Paragraph accepts WordPress XML exports, Substack ZIP exports, and Paragraph JSON or CSV exports.
Preview the archive
Open Settings → Post portability, choose the source, and upload the export file. Paragraph shows the posts 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 posts already imported. If some posts fail, download the failure report and retry just those.
Export and crosspost
Settings → Post portability also lets you download your posts as JSON, and publish new entries from another site's RSS feed without importing its archive. To export subscribers, use Export CSV in Subscribers (Starter plan and above).
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.