# WordPress.com (/docs/wordpress-com)



The WordPress.com integration uses **OAuth** to connect your WordPress.com account and publish articles directly to your hosted blog.

> This integration is for **WordPress.com** hosted blogs only. For self-hosted WordPress (WordPress.org), see the [WordPress plugin integration](/docs/wordpress).

Prerequisites [#prerequisites]

* A WordPress.com account with at least one site
* Publish permissions on the target site
* An EarlySEO account

Setup [#setup]

1. Start the OAuth flow [#1-start-the-oauth-flow]

1. Go to **Integrations** in your EarlySEO dashboard
2. Click **Add Integration** and select **WordPress.com**
3. Click **Connect with WordPress.com**  you will be redirected to WordPress.com to authorize

2. Authorize EarlySEO [#2-authorize-earlyseo]

In the WordPress.com authorization screen:

1. Review the permissions requested (read profile + publish posts)
2. Click **Approve**
3. You will be redirected back to EarlySEO

3. Select your site [#3-select-your-site]

After authorization, EarlySEO loads all WordPress.com sites associated with your account. Select the site where articles should be published.

4. Choose publish mode [#4-choose-publish-mode]

| Mode        | Behavior                                     |
| ----------- | -------------------------------------------- |
| **Publish** | Articles go live immediately after sync      |
| **Draft**   | Articles are saved as drafts for your review |

5. Save [#5-save]

Click **Create Integration**. EarlySEO will now publish articles to your chosen WordPress.com site.

Supported Site Types [#supported-site-types]

* Personal and Business WordPress.com blogs
* Sites with Jetpack enabled
* Sites where you have **Editor** or **Administrator** role

What Gets Published [#what-gets-published]

When EarlySEO publishes an article to WordPress.com, the following data is set:

| Field              | Source                                                                     |
| ------------------ | -------------------------------------------------------------------------- |
| **Title**          | Article title                                                              |
| **Slug**           | Generated URL-friendly slug                                                |
| **Content**        | Article HTML (images are automatically sized to fit your theme)            |
| **Excerpt**        | Article summary / meta description                                         |
| **Featured Image** | Uploaded to your WordPress.com media library and set as the post thumbnail |
| **Tags**           | Article tags / keywords (auto-created if they don't exist)                 |
| **SEO Metadata**   | Meta title and meta description (compatible with Yoast SEO and AIOSEO)     |

Troubleshooting [#troubleshooting]

**No sites appear after authorization**

* Your account may not have any active sites with publish permissions
* Check that your account has at least **Editor** role on the site

**Articles are not appearing on your site**

* If publish mode is **Draft**, check your WordPress.com Drafts section
* Confirm the WordPress.com site is not set to Private

**Re-authorization needed**

* OAuth tokens can expire  delete the integration and reconnect to refresh
