Importing Articles

---
title: Importing your existing Shopify blog articles into BlockPress
section: Getting Started
slug: importing-articles
---


If you've been writing in Shopify's native editor (or another app), you can pull those articles into BlockPress so you get the editor, SEO scoring, and Article Health audit on every post going forward.


## How it works


BlockPress doesn't duplicate your articles — it manages the ones that already live on Shopify. Importing means BlockPress parses the existing HTML into block format so you can edit it like any new post.


## Steps


1. Open `/app/posts` — every article in your Shopify store shows up here
2. Posts marked as **Legacy** are articles BlockPress hasn't managed yet
3. Click any Legacy post to open it in the editor
4. BlockPress converts the existing HTML into blocks automatically
5. Save once to mark it as **BlockPress-managed** — from here on, edits go through the BlockPress editor


## What converts cleanly


- Headings (H1–H6) → Heading blocks
- Paragraphs → Paragraph blocks
- Lists (ordered + unordered) → List blocks
- Images → Image blocks (with `srcset` regenerated on save)
- Embeds (YouTube, Vimeo, Twitter) → Embed blocks
- Tables → Table blocks
- Blockquotes → Quote blocks


## What might need cleanup


- **Custom HTML** (raw `<div>` layouts, theme-specific shortcodes) — preserved as a Raw HTML block but may need re-styling
- **Inline styles** (`<span style="...">`) — stripped during conversion in favor of clean semantic markup
- **Old image URLs** — kept as-is; if you want responsive sizes, re-upload through the Image block


## Bulk import?


There's no "import all at once" button by design — converting all your legacy posts in one go can accidentally wipe theme-specific styling that worked on your storefront. Walk through them as you edit each one for the first time.


## After import


Run the **Article Health audit** at `/app/health` (Pro plan) to see SEO/UX issues across your whole catalog after import. Most legacy articles have a couple of quick wins — missing alt text, weak meta descriptions, no internal links — that BlockPress will flag.


Questions about a specific article that won't import cleanly? Open chat and paste the URL.

Updated on: 26/05/2026