Troubleshoot the Tenwrite Plugin

Use this page when the Tenwrite plugin is installed but the SEO sync behavior does not look right.

Start with the Diagnostics Page

Open Tools > Tenwrite in WordPress admin.

Check these rows first:

Detected Adapters — shows whether Yoast SEO or Rank Math is active
REST Meta Registration — confirms the plugin registered its meta correctly
Last Sync Summary — shows the latest sync result
Errors — shows recorded problems; error lines and tracebacks appear when available

Fresh Tools > Tenwrite diagnostics with plugin 1.0.0, REST registration Ready, Detected Adapters None, Last Sync Stored only, and no errors

This example was captured from a site with no supported SEO adapter active. Its plugin registration is ready and SEO data was stored, but no Yoast SEO or Rank Math fields were updated.

Read the diagnostics as separate checks:

What you see	What it means or what to check
REST Meta Registration: Ready	The plugin registered its SEO data with WordPress. This alone does not confirm a vendor field update.
Detected Adapters: None	Yoast SEO and Rank Math were not detected. Other SEO plugins are not supported adapters.
Status: Stored only	Tenwrite SEO data was saved without being copied into a supported adapter.
Status: Synced	The plugin handled the saved values for the detected adapter. Check the post ID, time, and field counts to identify the operation.
Fields Updated / Fields Cleared	Shows which supported values were written or removed in that operation. Compare them with the fields you intended to send.

The summary is the most recent plugin sync, which may concern another post or a bulk re-sync. Check Synced At, the field counts, and Post when shown before treating it as the result of your export. These plugin diagnostics are separate from Tenwrite’s Sync Site Content index refresh.

Common Problems

SEO values are not showing up in WordPress

Check:

the Tenwrite plugin is active
Yoast SEO or Rank Math is active
the export or update actually included supported SEO fields

If neither Yoast SEO nor Rank Math is active, the plugin stores the SEO data but does not mirror vendor-specific fields.

I installed Yoast SEO or Rank Math after older posts were already exported

Go to Tools > Tenwrite and use Re-sync Existing Posts.

This backfills existing posts that already store Tenwrite SEO data.

Confirm that the supported SEO plugin is active before using it. Re-sync Existing Posts applies the values already stored in WordPress; it does not fetch a newer Google Doc or start AI generation. To send changed document values, use Sync Post on the existing item in Tenwrite instead.

I updated SEO frontmatter in Google Docs, but WordPress did not change

Updating the Google Doc does not update WordPress by itself.

After changing frontmatter:

save the Google Doc
return to Tenwrite
run Sync Post on the existing item

I cannot edit some SEO fields in Tenwrite

Those fields are likely already set in Google Docs frontmatter.

When frontmatter controls a field:

update it in the Google Doc
or remove it from frontmatter
then run Sync Post if you want WordPress updated

Frontmatter changes seem to override what I typed in Tenwrite

That is expected when frontmatter provides a value for the same field.

During export and sync flows, frontmatter wins for the fields it sets.

The plugin is active, but the diagnostics page shows no adapters

That means Yoast SEO and Rank Math were not detected.

Check that:

the SEO plugin is installed
it is activated on the same site
you are using a supported self-hosted WordPress site

I connected a WordPress.com site and the plugin does not work

The current plugin workflow is intended for self-hosted WordPress sites.

The SEO bridge is supported for self-hosted WordPress. See AI publishing support by destination for the other publishing fields available on WordPress.com.

If You Need to Report a Bug

When you contact support, include:

your WordPress version
whether you use Yoast SEO or Rank Math
the action you took in Tenwrite
the message shown in Last Sync Summary
any lines shown in Errors / Traceback

If you’re still stuck, email support@tenwrite.com with the steps you took, the error message, and your WordPress site URL.

Tenwrite is an independent product not affiliated with or endorsed by Google LLC, Blogger, or WordPress Foundation. Google Docs, Gmail, Google Workspace are trademarks of Google LLC. WordPress is a trademark of the WordPress Foundation.