How I migrated from Medium to and why?

For the last year, strange things were happening with Medium. Many people complained that Medium hides everything behind the paywall, but I didn’t get it, until recently… but let us start from beginning.

My first blog was a static page on GitHub, written in Markdown. They were deploying through Jekyll. I love everything about Jekyll and GitHub Pages, but when you need to make drafts, share them with your technical editor, got comments on your writing style, etc… it becomes harder to handle all of that, since these are just plain Markdown files.

While looking for other solutions, I’d found Medium a few years ago. It was a breakthrough. It has a WYSISYG editor, you can make drafts and share them with people, getting the feedback as comments to your lines. You were fixing those issues and “Publish”. Decent!

Everything was great until they had introduced paid membership. They were selling this with a motto “let your posts make you money” or something like that. It was optional, so I just refused and forgot about it. You still can read other’s people posts, write your own, so what is the difference, right?

For some time, yes, but… few days ago I log in into Medium to read some interesting posts about Computer Science and you know what I saw there? They hid almost every post on Medium behind the paywall. I’ll show you how it looks:


What is that, Medium? Are you kidding me?

And you will see this banner a lot, believe me. More and more posts on Medium are hiding behind the paywall. I had open like ~8 articles at that day and I could read only one; they hid others behind the banner you see above.

So I decided, I’m moving.

And I’m writing this post alongside the process of migration. Everything I’m doing right now for migration, I’m writing in this draft. So, read it with the idea in mind that you are sitting next to me in the office and looking how I’m doing that. Let us begin.

Export from Medium

What do we need to do in the first place? Right, export everything we had on Medium.

To do that, we are going to Medium. Go to “Profile -> Settings -> Account”. Look for “Download your information” section and, well, download it:


You will get an email with a link for downloading a zip archive with all your content. Now, when we got the archive, we need to import it somehow into

Import to has a tool for importing content from Medium.

Go to your website on “My Site -> Tools -> Import”.


As you can see, it has a lot of importers, so you can migrate from others’ resources. However, we are interested in Medium.

It asks for a zip file; you have downloaded early, so we give it and wait for some results..


I’ve waited for ten minutes, something like that. When has done with the import, I got an email notification about that and navigated to my posts on

screen-shot-2019-06-06-at-10.55.09 has migrated all of my posts from Medium – decent!


I wanted to double-check that import has not broken something. I mean, styling, embedded code or gists from GitHub, images, etc…

So I went through each of the imported posts and did a proofreading, nothing special here. If you by chance will find errors in my old posts, please notify me about that and I’ll fix it, thanks.

BTW, regard to proofreading, I am using the tool called ProWritingAid. It has checks for styling, grammar, Flesch–Kincaid readability tests and a lot more. I’d even say it worth describing the tool more in depth in another post.

Alternatives to help you with writing your posts are Hemingway App or Grammarly.

Though we are already getting off the tracks, let us return to the migration. We have posts on; In my case, they are available at And let us say we can just take our custom domain and switch it to the Not so fast…

Backward Compatibility

What about old links somewhere in notes, bookmarks? For example, the same article and links to both Medium and


As you can see, they have different permalinks, so switching the domain right away will break all the links in Medium style. That means we need to support old permalinks in We need to find a way route Medium links to posts. Redirects come to the rescue.

But first, you need to get all the links to your Medium posts. I have scrapped them into my Notes:

Screen Shot 2019-06-07 at 08.57.50.png

Ready to create redirects turns out that does not have a built-in functionality for that (I am shocked). They have plugins, but you can install them only if you have a business plan bought. Well, I do not.

Let us find some way around that…

After a few hours of brainstorming, I’d found a way to overcome this limitation. You can create custom pages on and as their slugs you need to provide the old links from Medium.

Here, for example, I want to notify users that will go by the old link to “How does Node.js work?”, that it is no more correct and that you need to follow another link.

Screen Shot 2019-06-07 at 12.41.59.png

Inspect the URL of the page. Remember, we were talking about Medium links like Now, these links are just custom pages on, where you can notify your readers about the migration and give them a valid link to the post.

It is not 301 or 302 redirects, so I’m afraid it will confuse search engines about what is happening there. But what choices do we have here? At least, we can notify readers where to go, instead of “the page is not found”.

Switch the domain

Now, when all the preparations were done, we could go to our domain registrar and update records, in my case, to point to name servers instead of Medium ones and finish the migration.

I will skip the story of updating DNS records, because, this is custom thing and differs from one registrar to another. All you need to know is that at this step, you just need to update your DNS record and you can find all the documentation about that at your domain registrar and documentation.


Let us summarize:

  • We had exported all our content from Medium;
  • Imported it into;
  • Made a proof-reading to ensure that everything looks perfect;
  • It is “backward compatible” with old Medium links;
  • Switched the custom domain to point to the name servers;

We migrate the blog, congratulations!

Eugene Obrezkov, Senior Software Engineer, Kyiv, Ukraine

3 thoughts on “How I migrated from Medium to and why?

  1. Hello. I really like your article about BootLoader. It’s been removed from medium but I don’t see it in wordpress.
    Did you removed it on wordpress too?


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.