Migrating to Bear
Moving your blog to Bear? Great! Here's how to do it without losing traffic or breaking links.
If you have a large blog to migrate, email me (Herman) and I'll help move your posts over.
There's no bulk importer, since every platform from Substack to Blogger exports things differently. If you have a backup of your posts, though, you can restore it to your new blog using the API.
Before you start
Leave your custom domain where it is until your new blog is ready. Set everything up at https://your-blog.bearblog.dev first and you'll have no downtime.
Moving posts over
The simplest way is to create a new post and paste in the content from the old one, one post at a time. It's less work than it sounds: roughly 30 minutes for a 60 post blog.
Bear handles both Markdown and HTML, so you can paste either:
- Have an HTML backup? Paste it in as is.
- Prefer Markdown? It's easier to edit later. Convert your posts with HTML-to-Markdown.
- Coming from WordPress? Try the third-party WordPress to MD converter.
Set each post's published_date to its original publication date.
If your posts all share a similar structure, set up your post template first (in the posts section of your dashboard). It saves you retyping the same attributes for every post.
Keeping your links working
Bear supports both flat paths (https://your.blog/post-title/) and nested paths (https://your.blog/2021/02/13/post-title/).
To keep an old nested path, set the post's link to 2021/02/13/post-title.
To use a new path, add the old one as an alias. Visitors to the old path get forwarded to the new one instead of hitting a 404:
title: Post title
link: post-title
alias: 2021/02/13/post-title
Images
Re-upload the images in each post, otherwise they'll break when you move your domain.
RSS feed
If your old feed lived at a different path, like https://example.com/rss/index.xml, add it in Settings > Advanced settings > RSS alias so existing subscribers keep getting your posts. For that example, the RSS alias would be rss/index.xml.
Upvotes
There's currently no way to bring upvotes over from other platforms.
Moving your domain
Once everything looks good at https://your-blog.bearblog.dev, it's time to move your domain over. You do this by updating your DNS records, which the custom domain docs walk you through.