Migration guide
Migrate from Notion to RankFlo
Move your Notion-as-CMS workflow to a real CMS without losing the workflow.
Why move from Notion
- Real publishing pipeline — drafts, scheduled publishing, approvals
- Real SEO — Notion's public pages don't rank
- Custom domain without Super.so / Potion / Feather subscriptions
- Type-safe API for any frontend
- Real analytics, not just Notion's basic page views
- Team roles and permissions actually work
Things to plan for
Edge cases that come up on most Notion → RankFlo migrations.
Notion's blocks → Tiptap blocks
Notion's block model is rich (toggles, callouts, databases, embeds). Our importer maps the common ones; databases inside posts need manual handling.
Embedded databases
If a post embeds a Notion database (e.g. a related-posts list), the database content doesn't transfer as live data — it becomes a snapshot. Recreate as RankFlo tags.
Image references
Notion images are hosted at signed S3 URLs that expire. The importer fetches and re-uploads images during migration.
Step-by-step migration
5 steps. Export format: Markdown + CSV (.zip)
- 1
Export Notion content
10 min for large workspacesNotion → ⋯ menu → Export → Markdown & CSV. Download the .zip.
- 2
Pick which pages are blog posts
Notion exports everything. Filter to just the pages that are blog content.
- 3
Run the Notion importer
5–15 minSettings → Import → Notion (Markdown). Upload the .zip. Markdown is converted to RankFlo blocks.
- 4
Map Notion properties to RankFlo metadata
Properties like "Status", "Author", "Tags" need mapping to RankFlo fields. The importer prompts you.
- 5
Spot-check formatting
Notion-specific blocks (toggles, columns, callouts) may need review. Toggle blocks become collapsible HTML; columns are flattened.
After the migration
SEO and operational checklist — don't skip these.
- ✓Set up 301 redirects from old URLs to new RankFlo URLs
- ✓Submit your new sitemap to Google Search Console
- ✓Verify all internal links resolved correctly
- ✓Re-add SEO meta titles and descriptions where missing
- ✓Configure your custom domain and HTTPS
- ✓Run a crawler (Screaming Frog) against the new site to catch broken links
Ready to leave Notion?
Start a free trial — the importer ships with every plan.