Import a WordPress blog into HubSpot with WordPress connect

Last updated: January 5, 2026

Available with any of the following subscriptions, except where noted:

All products and plans

With WordPress connect, you can import your WordPress blog into HubSpot using your blog’s homepage URL. It's the fastest and most automated method when your WordPress site supports the standard WordPress REST API.

Before you get started

Before you begin the import process, confirm you meet these requirements and understand any limitations of the WordPress connect feature.

Permissions required The following permissions are required:

Edit permission is required to create and edit blog posts.
Publish permission is required to publish blog posts.
Import permission is required to import blog posts.

Understand requirements

You'll need your WordPress blog's homepage URL to import your blog in to HubSpot.
Blog posts must have a title and post body set in WordPress to be imported.

Understand limitations & considerations

The WordPress connect feature isn't compatible with custom post types in WordPress.
If your WordPress site doesn't support the standard WordPress REST API, use the XML or CSV import options instead.

Import a WordPress blog

In your HubSpot account, click the settings settings icon in the top navigation bar.
In the left sidebar menu, navigate to Content > Blog.
Click the Current view dropdown menu and select Import blog.

On the Content Import page, click the Start new import dropdown menu and select Blog posts.
Select WordPress connect and then click Next.
Enter the URL of your blog's listing page in the Blog homepage field.

Please note: if you see the message “This blog is not compatible with WordPress Connect” it means HubSpot 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).

Click the HubSpot blog dropdown menu and select the blog where the imported posts will be hosted. If you need to create a new blog, click Create new blog instead. Learn more about creating a blog in HubSpot.
In the bottom right, click Copy blog posts. The import process can take some time, depending on the amount of information being imported. The blog importer tool will collect the following elements from each blog post:
- Title: the title of your blog post.
- SEO title: the title that appears in the browser title bar and in search results.
- Author: your blog post author. Author images won't be imported unless they are included in the post body.
- Publish date: the date your blog post was published.
- Featured image: the thumbnail image featured when your blog post is shared.
- Categories/Tags: the categories and tags applied to your blog posts.
- Meta description: the short description of your blog post that appears in search engine results.
- Post body: the main content of your blog post.
While your blog posts are being retrieved, the import status will update to: Preparing posts for import.

Review imported blog posts

After the tool finishes scanning the blog posts, the import status updates to Posts ready for import. You can then review the posts included in the scan and complete the import.

Navigate back to the blog import tool:
- In your HubSpot account, click the settings settings icon in the top navigation bar.
- In the left sidebar menu, navigate to Content > Blog.
- Click the Current view dropdown menu and select 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 right 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.
- Enter the values in the text field to the desired values.
- Click Save to apply these values to all blog posts.
By default, none of the blog posts are selected for the import. Select the checkbox on the left of any blog posts you want to include in your import.
When finished, click Import.
In the dialog box, select whether to import these blog posts as drafts or as live-published posts.
To overwrite any existing content, select the Overwrite any existing content with imported content checkbox.
Then click Save.
While your blog posts are being imported, the import status will update to Import in progress.
- 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.

Next steps: set up a blog in HubSpot

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

Edit your blog settings to customize your blog title, URL, and social sharing options.
Configure your blog subscription options to send email notifications to your blog subscribers.
Set up the rest of your company logo and branding in HubSpot.
Learn how to edit your blog template to control the styles and appearance of your blog. If you're using a theme from your Content Hub account or the Asset Marketplace, learn how to apply a theme template to your blog.
Learn how to edit and publish a new blog post in HubSpot.

Was this article helpful?

This form is used for documentation feedback only. Learn how to get help with HubSpot.