Blog

Import your WordPress blog into HubSpot

Last updated: October 21, 2020

Applies to:

Marketing Hub  Professional, Enterprise
CMS Hub  Professional, Enterprise

WordPress Connect is the easiest way to import a WordPress blog into HubSpot. This new feature uses the open WordPress REST API to import your blog content quickly, easily, and accurately.

Before you get started

  • When you create your HubSpot account, there will be a new default blog in your account you can use to import your blog posts. 
  • You'll use your blog homepage URL to import your WordPress blog in HubSpot.
  • The WordPress connect feature isn't compatible with custom post types in WordPress.

Enter your WordPress blog URL

  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In the left sidebar menu, navigate to CMS > Blog.
  • In the upper right, click Import blog.
  • In the Blog Importer tool, click Import new blog.
  • In the dialog box, select Wordpress connect, then click Next.
  • Set up your import:
    • Blog homepage: enter the URL of your blog homepage.

Please note: if you see the message “This blog is not compatible with WordPress Connect” it means we cannot get a successful API response from your WordPress blog. You can import your WordPress blog with an XML file instead. The most common reasons you may see this error message are:

  • The blog you are attempting to import isn’t a WordPress blog.
  • You are using one or more WordPress security plugins that restrict access to the WordPress API.
  • Other server configuration issues prevent us from reaching the site (e.g., an expired SSL certificate).
    • HubSpot blog: click the dropdown menu to select the HubSpot blog you want to import these blog posts into.
  • Click Copy blog posts.

The import process may take several minutes. The blog importer tool will collect the following elements from each blog post:

    1. Title: the title of your blog post.
    2. SEO title: the title that appears in the browser title bar and in search results.
    3. Author: your blog post author.
    4. Publish date: the date your blog post was published.
    5. Featured image: the thumbnail image featured when your blog post is shared.
    6. Categories/Tags: the categories and tags applied to your blog posts.
    7. Meta description: the short description of your blog post that appears in search engine results.
    8. Post body: the main content of your blog post.

While your blog posts are being retrieved, the import status will read: Preparing posts for import.

Review your blog posts

After the tool has finished scanning your blog posts, the import status will read: Posts ready for import.

After import status changes to Posts ready for import, you can review your posts and complete your import.

  • Navigate to the blog importer tool.
    • In your HubSpot account, click the settings icon settings in the main navigation bar.
    • In the left sidebar menu, navigate to CMS > Blog.
    • In the upper right, click Import blog.
  • Click Review results. You'll see a listing of blog posts, and any other pages collected from your WordPress website.
  • To preview a specific post, click Preview to view the page and see a listing of all values the tool identified for that post.
  • If any default values were applied to your blog post features, you'll see a note that reads: Default values used to complete mappings.
    • To review the default values, click Change default values.
    • In the slide in panel, review the default values for any blog features that couldn't be mapped for every blog post. In this example, there's a default value populating for the blog Author and blog Publish date.
    • Update the values in the text field to the desired values.
    • Click Save to apply these values to all blog posts.

review-default-values-for-blog-posts

  • All blog posts are selected for your import by default. Deselect the checkbox on the left for any blog posts or pages you want to omit from your import.
  • After you've finalized your selection, click Import.
  • In the Publishing status dialog box, select whether to import these blog posts as drafts or as live published posts. Then click Save.

Your blog import will update to Import in progress status. Once the import is complete, the status will update to Import completed. 

If there are any errors during the import process, the status will update to Import succeeded with some errors. You can review the details by clicking More > View details.

If you need to retry the import process, you can import your WordPress blog using an XML file instead.

Next steps: set up your blog in HubSpot

After you've imported your blog posts, finish setting up your blog in HubSpot: