Trouble importing content using the import tool

Medium uses a third-party service to handle the technical side of importing a single story to Medium. We send a request to their API with the URL to be imported, and they return the contents of the URL to the best of their ability.

If the import tool is not able to interpret the page, you may see a blank page when you try to import or an error message. If that happens to you, you would need to manually import your post to Medium instead of using the import tool.

Manual migration of a post

Step 1: Copy-paste your content

  1. Click on your profile picture in the top-right corner of the page to open a menu.
  2. Click New story to create a new draft.
  3. Copy the content you wish to publish on Medium and paste it to your newly created draft.
  4. Add images, embeds, and any additional content that is missing on your draft. Format your article using the Medium editor to make it look good. See this article to learn more about using the editor.

Step 2: Add a canonical link (optional)

You can optionally add a canonical link to your imported posts to make sure your SEO won't be penalized. Learn more here.

  1. Enter edit mode either by starting a new draft, or by visiting your story page, clicking the  three-dot button in the top-right corner and choosing Edit story.
  2. In edit mode, click the  three-dot button in the top-right corner of the page.
  3. From the drop-menu, click Customize canonical link.
  4. Enter your link and click Save. Make sure to click Publish to publish your changes.

Step 3: Publish the draft

  1. When you're finished with your post, click Publish.
  2. From the Publish review step, you can optionally add tags, customize your title and subtitle, schedule to publish your post later, and more.
  3. You can also select whether to make your post eligible for curators to review and distribute via topics on Medium. This means that your post is eligible to be part of Medium’s metered paywall. If you leave the box unchecked, your post will not be eligible for review and will be distributed only to your followers. Learn more about distribution and the paywall here.
  4. When you're done making changes, click Publish now to make the story immediately visible on Medium and available for anyone to read. All of your published stories can be found on your public profile page, as well as on your stories page.

Note: You may only import content from other sites for which you have the right to do so.

Was this article helpful?
Have more questions? Submit a request