Skip to content

[10], plugin 10: Subset PersonaMark

Work through your PersonaMark to-dos from inside WordPress

See PersonaMark's to-dos and apply its title and description rewrites.

Subset PersonaMark connects your site to PersonaMark with a site API key. It shows the latest audit's to-dos in wp-admin, and in the block editor you apply PersonaMark's title and meta description rewrites one at a time, after seeing the before and after.

To install and update the free plugins from wp-admin, add the Subset Installer.

DocumentationChangelog

Requires
WP 6.5+ · PHP 8.1+
Tested to
WP 7.1
WP-CLI
Yes
Multisite
Yes
Editions
Free

How Subset PersonaMark works

In PersonaMark, make a key in the site's Settings → API tab, then paste it under Subset → PersonaMark → Settings and choose Connect. The plugin asks PersonaMark which site the key belongs to, adds PersonaMark's verification meta tag to your pages, and asks PersonaMark to check it on your homepage. The key never reaches the browser, and SUBSET_PERSONAMARK_API_KEY in wp-config.php can hold it instead.

The Overview tab shows the latest audit's score out of 100 and its to-dos, each with its severity, the pages it affects and a link to it in PersonaMark. Run audit starts a new audit, and reloading the tab shows when it's done. If PersonaMark can't be reached, the tab shows the last results it sent, with their date.

In the block editor, the PersonaMark panel in the post's settings lists the issues the latest audit found on that page and PersonaMark's rewrites of its title and meta description. Each rewrite shows the current text next to the suggestion, and nothing changes until you choose Apply and confirm. The text applied is the text PersonaMark holds at that moment, fetched again on your server rather than taken from the browser.

A change goes to Subset SEO when it's active, otherwise to Yoast SEO or Rank Math. Without an SEO plugin, a title goes to the post's own title and a description can't be applied. A revision is saved before and after each change, with the SEO fields in it, so you can undo it from Revisions.

What it includes

Everything Subset PersonaMark does is free. There’s no licence to buy.

Free

Full plugin

No time limit and no upgrade nags.

  1. Connection with a PersonaMark site API key, stored encrypted
  2. PersonaMark's ownership verification meta tag
  3. The latest audit's score and to-dos in wp-admin
  4. Run audit from wp-admin
  5. Each page's issues in a block editor panel
  6. Title and meta description rewrites, applied one at a time
  7. A revision for every applied change
  8. Writes to Subset SEO, Yoast SEO, Rank Math or the post title
  9. Multisite, with a key for each site

You need a PersonaMark account

PersonaMark is a separate paid product from Subset that checks how your website is doing. An audit crawls the site for search problems and tests its speed. AI personas try real tasks on your live site, like finding a price, and report where they got stuck. PersonaMark also writes new titles and meta descriptions for your pages, and this plugin applies them.

Subset PersonaMark is free, and it does nothing until you connect it to PersonaMark. Before you install it, you need:

  • A PersonaMark account, with your site added to it
  • A site API key, made in the site's Settings → API tab in PersonaMark

Questions

Do I need a PersonaMark account?
Yes. PersonaMark is a separate paid service, at personamark.app, that audits your site. The plugin is free, and it does nothing until you connect it with a site API key from your PersonaMark account.
Does it show personas in WordPress?
No. The plugin shows the latest audit's score, to-dos, page issues and rewrites, each with a link into PersonaMark. Personas and everything else about an audit stay in the PersonaMark app.
What does my site send to PersonaMark?
Each request carries your site API key. Opening the PersonaMark panel on a published post also sends that post's address, to find its page in the latest audit. Post content isn't sent, and nothing is sent until you choose Connect.
Which SEO plugins does it write to?
Subset SEO when it's active, otherwise Yoast SEO, then Rank Math. Without one, a title rewrite changes the post's title, and a description rewrite can't be applied. If two are active, the subset_personamark_seo_target filter picks one.
Can I undo a rewrite I applied?
Yes, for post types that keep revisions. Each change is saved as a revision with the SEO title and description in it, so restoring the revision before it puts the old text back. The panel tells you when a post type keeps no revisions, before you confirm.
Who can apply a rewrite?
Anyone who can edit the post. Connecting the site, checking the connection and running an audit need the manage_options capability, which administrators have.
Does it work on multisite?
Yes. Each site connects to its own PersonaMark site with its own key, and each site's administrators manage it. Deleting a site from the network deletes its key.
What happens when I delete the plugin?
Its settings, the stored key and the cached answers from PersonaMark are deleted, on every site of a network, and the verification tag goes. Titles and descriptions you applied stay, and so do their revisions.

Underneath

Every Subset plugin has WP-CLI commands and documented hooks and filters.

Read the developer reference

WP-CLI
$ wp subset personamark connect < key.txt
$ wp subset personamark audit run --wait
$ wp subset personamark apply 42 rw_123 --field=title --user=admin

Hear about Subset PersonaMark releases

We’ll email you when Subset PersonaMark has a new release, and only about Subset PersonaMark.

One confirmation email, then nothing until we have news. Unsubscribing takes one click and no account.

We will email you a confirmation link. Click it and you are on the list. Until then nothing is confirmed.