MeshrBeta
WordPress.com Integration

WordPress.com Documentation

Everything you need to integrate Meshr with your WordPress.com site using OAuth authentication

WordPress.com vs Self-Hosted WordPress

This guide is specifically for WordPress.com sites (hosted at wordpress.com). If you're using a self-hosted WordPress installation (your own domain), check out our WordPress plugin documentation or self-hosted REST API documentation.

Quick Start

OAuth Connection

  1. Log in to your Meshr dashboard
  2. Click "Add Website" and select WordPress as your platform
  3. Enter your WordPress.com site URL (e.g., mysite.wordpress.com)
  4. Meshr will detect that it's a WordPress.com site
  5. Click "Connect with OAuth" to initiate the WordPress.com authorization flow
  6. You'll be redirected to WordPress.com to authorize Meshr
  7. After authorization, you'll be redirected back to Meshr
  8. Your WordPress.com site will be automatically connected

Setting Up OAuth

WordPress.com uses OAuth 2.0 for secure API access. This allows Meshr to access your WordPress.com site without storing your password.

Step-by-Step OAuth Guide

  1. When you click "Connect with OAuth", Meshr initiates the authorization request
  2. You'll be redirected to WordPress.com's authorization page
  3. Log in to your WordPress.com account if you're not already logged in
  4. Review the permissions requested (global scope for site access)
  5. Click "Authorize" to grant Meshr access to your WordPress.com account
  6. WordPress.com will redirect you back to Meshr with an authorization code
  7. Meshr exchanges this code for an access token (this happens automatically)
  8. Your WordPress.com sites will appear in the Meshr dashboard

How Meshr Detects WordPress.com

Meshr automatically detects if your site is hosted on WordPress.com by checking:

  • If your site URL ends with .wordpress.com
  • If your site hostname contains wordpress.com
  • Meshr uses pattern matching to detect WordPress.com sites automatically

Once detected, Meshr will automatically use OAuth instead of application passwords for authentication.

After Connection

Once your WordPress.com account is connected, Meshr will:

  1. Discover all sites associated with your WordPress.com account
  2. Allow you to select which site(s) you want to analyze
  3. Automatically detect posts, pages, and custom post types
  4. Begin analyzing your content for internal linking opportunities
  5. Enable automated link updates through the WordPress.com REST API

OAuth Permissions

Required Scope

Meshr requests the "global" scope, which provides:

  • Read access to your sites, posts, and pages
  • Write access to update posts and pages with internal links
  • Access to site settings and configuration

These permissions allow Meshr to analyze your content and automatically add internal links to improve your SEO.

Compatibility

Supported Content

  • ✅ Blog posts
  • ✅ Pages
  • ✅ Custom post types
  • ✅ WordPress.com themes

Requirements

  • ✅ Active WordPress.com account
  • ✅ Site owner or admin access
  • ✅ OAuth authorization granted
  • ✅ WordPress.com REST API enabled

Troubleshooting

Common Issues

OAuth redirect fails

Make sure you're using the correct WordPress.com account. If you have multiple accounts, ensure you're logged into the one that owns the site you want to connect.

Sites not appearing

Only sites where you have owner or admin access will appear. If a site doesn't show up, check your permissions in WordPress.com.

Wrong authentication method

If Meshr is asking for application passwords instead of OAuth, make sure your site URL is correctly identified as a WordPress.com site (should end with .wordpress.com or be recognized as WordPress.com).

Reconnecting your account

If you need to reconnect, go to your Meshr dashboard, disconnect the existing connection, and reconnect using OAuth again. You may need to revoke access in WordPress.com settings first.

Ready to Transform Your Internal Linking Strategy?

Free 7-day trial • Cancel anytime

Join websites that have increased organic traffic by 32% with Meshr's platform-agnostic internal linking tool.

Works with websites, Webflow & WordPress
Semantic AI-powered suggestions
Enterprise-grade security & support