Bear docs

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:

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.

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.