How to import articles from Markdown or HTML files

If you write articles in another tool, such as an AI writer or another blog, you can upload the files and your site turns each one into an article. The images in your files are copied to your site too. You can import up to 20 files at a time.

How to import your files

  1. In your site admin, go to Articles > Write with AI > Import Articles.
  2. Drag your files into the Article files box, or click Choose files.
  3. Click Import.

A message says Importing your articles. The import runs in the background, so you can keep using your site admin while it works. Copying the images can take a few minutes.

When it finishes, you get one notification under the bell icon at the top of your site admin. Its title tells you how it went, for example 2 Articles Imported, 1 Skipped. For each file it shows:

  • Whether the file was Created or Skipped, and the reason for any file that was skipped.
  • How many images were copied to your site.
  • Any image that kept its original address, and why.
  • Which image was set as the article's hero, listing or social image.

Click View articles in the notification to go to your articles.

Each imported article is saved as disabled, so nobody sees it yet. Check it, then enable it from its Settings tab to publish it.

File rules

  • Files must end in .md (Markdown) or .html.
  • Each file can be up to 1 MB.
  • Scripts are removed.

Images in your files

Images in your files are copied to your site, so your article does not depend on the site they came from.

An image keeps its original address when it cannot be copied. For example:

  • It uses a relative link, such as images/photo.jpg. Upload that image in the article editor instead.
  • The file is over 10 MB.
  • It is not a JPEG, PNG, WebP or GIF image.
  • It is hosted on Amazon. Amazon images stay on Amazon.
  • The article has more than 30 images, or the image could not be downloaded.

The notification lists each image that kept its address, with the reason.

Listing, social and hero images

The first image in the article that is at least 600 pixels wide becomes the article's listing and social image. It is not used as the hero image, because the hero shows above the article text and the same picture would show twice.

To choose the image yourself, add image: with the image address to the front matter (see below). That image is used as the hero, listing and social image. Your file can also use featured_image, cover_image, hero_image or thumbnail for the same thing.

Add the title and SEO fields

Put the article details at the top of the file, between two lines of three dashes. This is called front matter:

---
title: Best Wine Fridges
slug: best-wine-fridges
subtitle: Our top picks for every kitchen
meta_title: Best Wine Fridges for 2026
meta_description: The wine fridges we recommend, and why.
meta_keywords: wine fridge, wine cooler
author: Jane Smith
categories: [Guides, Kitchen]
image: https://example.com/wine-fridge.jpg
---
  • Only the title is needed. Every other field is optional.
  • Without a title, the first H1 heading in the file is used.
  • Categories must already exist in Articles > Categories.
  • An HTML file can use its own page title, meta description and meta keywords tags instead.

Questions and Troubleshooting

Why was my file skipped?

The import notification gives the reason under each file. The usual ones are:

  • The file has no title and no H1 heading. Add a title to the front matter.
  • An article with the same slug already exists. Change the slug in the front matter and import the file again.
  • The file does not end in .md or .html, or it is empty.

Why did an image keep its original address?

The notification gives the reason next to each image. See Images in your files above for the usual ones. To move the image to your site, upload it in the article editor.

I got an "Article Import Stopped" notification

The import stopped before the end, so some files may not be imported. Check Articles for the ones that are there, then import the rest again. If it stops again, contact our support team.

Why is my imported article not showing on my site?

Imported articles are saved as disabled. Enable the article from its Settings tab.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.