M
Masthead Pro · Plugin Documentation

Your articles, finally found.

You write brilliant work. Masthead Pro makes sure Google — and the new wave of AI search engines — can actually read, understand, and surface it to people looking for exactly what you write about.

No coding experience required  ·  Works with Yoast  ·  WordPress 6.0+  ·  v1.1.0

🔍

Google understands your articles

Right now Google can read your words — but it doesn't fully understand what your article is. Masthead Pro adds invisible labels behind the scenes that tell Google: "this is an article, written by this person, on this date, about this topic." Google rewards that clarity.

🤖

AI search engines can cite you

When someone asks ChatGPT, Perplexity, or Google's AI overview a question, it pulls answers from articles it can understand clearly. Without Masthead Pro, your articles are harder for AI to parse. With it, you're a better candidate to be cited.

📋

Rich results in search

Ever seen those Google results with expandable questions underneath? Or results with star ratings and images? Those are called rich results. Masthead Pro unlocks them for your articles — specifically the Q&A style cards that take up far more space in search results.

Plain English Explainer

What's actually happening
behind the scenes

No jargon. Here's exactly what Masthead Pro does and why it matters — explained simply.

1
Structured Data

The invisible label on every article

When you upload a product to Amazon, you fill in a form: product name, category, price, dimensions, photos. That structured information helps Amazon show it to the right people.

Masthead Pro does the same thing for your articles. It automatically fills in an invisible "form" that tells Google and AI engines: who wrote this, when, what it's about, what publication it belongs to, and how long it takes to read. Google loves this clarity.

💡

Think of it like this: Your article is a beautifully wrapped gift. Masthead Pro adds a tag to the outside that says exactly what's inside — so it ends up under the right tree.

2
Open Graph Tags

How your articles look when shared

When someone shares your article on Twitter, LinkedIn, or Facebook — have you noticed some links show a big beautiful preview image with a title and description, while others just show a plain URL?

The difference is Open Graph tags — invisible instructions that tell social platforms what image, title, and description to show. Masthead Pro writes those instructions automatically for every article you publish.

💡

Think of it like this: It's the difference between someone holding up a plain brown envelope and holding up a beautifully designed book cover. Same content — completely different first impression.

3
Breadcrumbs

Showing Google where your article lives

Breadcrumbs are the little trail you sometimes see in Google results, like: The Journal → AI & Science → Artemis II. They help Google understand the structure of your site — which articles belong to which categories.

This matters because Google uses this hierarchy to understand your expertise. If you've written 10 articles under "AI & Science," the breadcrumb trail signals that you're an authority on that topic.

💡

Think of it like this: It's like telling a librarian not just what your book is about, but which floor, which section, and which shelf it belongs on.

4
FAQ Schema

The Q&A cards that appear in Google

This is one of the most powerful features. If your article answers questions — and most good articles do — you can tell Google what those questions and answers are. Google may then show them as expandable cards directly in search results, before anyone even clicks.

This means your article takes up more space in search results, and people who click already know you have the answer they're looking for. Much higher quality traffic.

💡

Think of it like this: Instead of a sign that says "Restaurant this way," it's a sign that says "Restaurant this way — open now, serves pasta, $25 average." People arrive knowing it's right for them.

Getting Started

Three steps to set it up

No developer needed. If you've ever installed a WordPress plugin before, this is exactly the same process — with one small extra step at the end.

1

Upload the plugin

In your WordPress admin area (the dashboard you log into to write posts), go to Plugins in the left sidebar, then click Add New Plugin, then Upload Plugin at the top of the page.

Choose the masthead-pro.zip file you downloaded, click Install Now, then Activate Plugin. That's it for step one.

ℹ️ If you've ever installed a plugin like Yoast SEO or Elementor, this is identical. The zip file goes in, the plugin comes out.
2

Tell it who you are

Masthead Pro needs to know the name of your publication, your website address, and a couple of other details so it can include them in the structured data it creates. You add these as a few lines of text to a file called wp-config.php.

Don't panic — here's exactly what to do: In your WordPress admin, go to Plugins → Plugin Editor. Or, if you have access to your web host's file manager (like cPanel), find the file at the root of your WordPress installation.

⚠️ Before editing wp-config.php: Make a backup copy first. Most hosts let you right-click and download a copy. This file is important — a backup takes 30 seconds and could save you a headache.

Find the line that says /* That's all, stop editing! Happy publishing. */ and paste the following lines directly above it:

Add these lines to wp-config.php
wp-config.php
// ── Masthead Pro Settings ─────────────────────────
// The name of your publication (what shows in Google)
define( 'MASTHEAD_PUBLISHER_NAME', 'The Journal' );
// Your website's main address
define( 'MASTHEAD_PUBLISHER_URL',  'https://lisapedrosa.com' );
// Full web address of your logo image (optional but recommended)
define( 'MASTHEAD_PUBLISHER_LOGO', 'https://lisapedrosa.com/logo.png' );
// Your Twitter/X handle, with the @ symbol
define( 'MASTHEAD_TWITTER_HANDLE', '@lisapedrosa' );
// The type of content you write. Leave as 'Article' unless
// you publish news (use 'NewsArticle') or casual posts ('BlogPosting')
define( 'MASTHEAD_DEFAULT_ARTICLE_TYPE', 'Article' );
// Leave these as 'true' — they enable extra features
define( 'MASTHEAD_ENABLE_FAQ_BLOCK',   true );
define( 'MASTHEAD_ENABLE_BREADCRUMBS', true );
Replace the example values (like The Journal and https://lisapedrosa.com) with your own details. Everything else can stay as-is.
3

Check it's working

Open any published article on your site. Right-click anywhere on the page and choose "View Page Source". Press Ctrl+F (or Cmd+F on Mac) and search for application/ld+json.

If you see a block of text starting with {"@context":"https://schema.org" — it's working. That's Masthead Pro's structured data, now attached to every article you publish.

🔎 For an even easier check, go to Google's Rich Results Test (search "Google rich results test"), paste your article URL in, and click Test. It'll show you exactly what Google can see.
Per-Article Control

Customise each article individually

Every article can have its own settings — you don't have to use them, but they're there when you need extra control. Here's what's available and what each one does.

✏️

How to access per-article settings

Open any post in the WordPress editor. In the top-right corner, click Screen Options (it's a small tab). Make sure Custom Fields is ticked. A new panel will appear at the bottom of your editing screen.

In that panel, you'll see a dropdown to choose a field name and a text box to enter a value. The fields below are the ones Masthead Pro reads.

ℹ️ You only need to fill these in if you want to override the automatic defaults. For most articles, Masthead Pro handles everything on its own.
📝

Write your own meta description masthead_meta_desc

The meta description is the two-line summary that appears under your article title in Google search results. By default, Masthead Pro generates one from the beginning of your article. But you can write a better one yourself.

Field name: masthead_meta_desc  ·  Keep it under 160 characters for best results. Think of it as your article's elevator pitch to someone deciding whether to click.

💡 Good meta descriptions answer the question "why should I read this?" in one or two sentences. Lead with the most interesting thing about the article.
🏷️

Add keywords masthead_keywords

Keywords help search engines understand the topics your article covers. If you've already set WordPress tags on the article, Masthead Pro uses those automatically. This field lets you add more, or be more specific.

Field name: masthead_keywords  ·  Format: just type them separated by commas, like: NASA, Artemis II, Moon mission, lunar exploration

🔇

Turn off structured data for one article _masthead_disable_schema

Sometimes you might have a page — like a Contact page or a landing page — where you don't want Masthead Pro to add any structured data. This field lets you turn it off for just that one page without affecting anything else.

Field name: _masthead_disable_schema  ·  Value: just type 1 to disable it on this page.

Most Powerful Feature

Q&A Cards in Google Search

This is the feature that can most dramatically increase the space your article takes up in Google — and the quality of people who click through to read it.

How to add FAQ cards to an article

In the Custom Fields panel of the article editor, add a field called masthead_faq. The value needs to be written in a specific format called JSON — don't let that scare you, it's just a structured list that looks like this:

Copy this template and fill in your own questions and answers
masthead_faq · Custom Field Value
[
  {
    "question": "Your first question goes here?",
    "answer": "Your answer to that question goes here."
  },
  {
    "question": "Your second question goes here?",
    "answer": "Your answer to that question goes here."
  }
]
⚠️ The format matters. Make sure every question and answer is inside "quote marks", and don't delete the curly braces { } or square brackets [ ]. If something breaks, copy the template above and start fresh.
💡 Prefer not to write JSON? The +AI generator below writes these FAQ pairs for you automatically — no formatting required.

What it looks like

Here's a live example of how the Q&A cards would appear for an Artemis II article. Click the questions to expand them — just like they behave in Google.

🔍 Google Search — Rich Result Preview
Question
What is Artemis II and why does it matter?
Question
Who flew on Artemis II?
Question
When will humans land on the Moon again?
These appear as expandable cards directly in Google — before anyone even clicks your article
AI FAQ Generator · Included

Generate FAQs with one click

The built-in AI FAQ Generator reads your article and writes the FAQ pairs, meta description, and keywords for you — straight into the right custom fields. No copy-pasting, no JSON formatting. Just one button.

Step 1 — Add your API key

In your WordPress admin, go to Settings → Masthead Pro. Paste your Anthropic API key into the field and click Save.

🔑 Get your key from console.anthropic.com → Settings → API Keys. It starts with sk-ant- and takes about 30 seconds to create.
🔒 Your key is encrypted before it's stored — it can't be read from the database without your wp-config.php file.

Step 2 — Pick a model (or don't)

On the settings page, type any current Claude model ID into the model field — or leave it blank to auto-select the best one available on your account. Click Refresh model list to load the models your key can access and choose from the dropdown.

♻️ Because you choose the model, Masthead Pro keeps working when Anthropic releases new models or retires old ones — there's nothing to update in the plugin.

Step 3 — Click Generate on any article

Open any post in the editor. In the right sidebar you'll see a 🤖 Masthead AI panel. Click ✨ Generate with AI, review the preview of your FAQ pairs, meta description, and keywords, then click Apply to Custom Fields to save them instantly.

⚠️ Applying overwrites any existing masthead_faq, masthead_meta_desc, and masthead_keywords values. The preview shows exactly what will be saved before you commit.

Tracking your usage

The Settings → Masthead Pro page shows a live usage dashboard so you always know how much you've spent and when to top up your Anthropic credits.

AI Usage Dashboard Settings → Masthead Pro

Articles generated

24

Estimated cost

$0.09

Recent generations

2026-04-12 17:26 1,842 in / 612 out $0.0147
2026-04-12 17:18 2,104 in / 598 out $0.0152
2026-04-12 16:55 1,993 in / 587 out $0.0148
💰 At typical article lengths, each generation costs $0.003–$0.005. A $5 Anthropic top-up covers roughly 1,000–1,500 articles.
Built-in Quality Check

Your article's readiness score

Masthead Pro includes a behind-the-scenes score that tells you — before you publish — how well your article is set up for search and AI engines. Here's what it checks.

To see your score: publish your article, open it in your browser, then right-click anywhere and choose Inspect or Inspect Element. Click the Console tab. Look for a line that says 🗞 Masthead Pro — AEO Readiness. Click the triangle to expand it.

This only shows up when your site has WordPress debug mode turned on — it's not visible to your readers, only to you.

What the eight checks mean

Structured data present

The invisible article label is attached and working. This is the foundation — everything else builds on top of it.

Breadcrumb trail set

Google can see where this article sits in your site's structure (Home → Category → Article).

FAQ cards added

You've added Q&A pairs — these are eligible to appear as expandable cards in search results. The single biggest boost you can make.

Featured image set

Articles without a featured image rarely appear in visual search carousels or image-rich previews.

Meta description written

The two-line summary shown in Google. Without one, Google picks its own — usually not the best choice.

Excerpt set

The WordPress excerpt field — a hand-written summary that AI engines often prefer over auto-generated ones.

Keywords added

Topic signals that help AI parsers understand what your article is specifically about.

Category assigned

A WordPress category tells Google what section of your site this article belongs to — building your topical authority.

Example score — before and after adding FAQ cards

Before — no FAQ added

AEO Readiness Score
76/100
Structured data present
Breadcrumb trail set
FAQ cards added
Featured image set
Meta description written
Excerpt set
Keywords added
Category assigned

After — FAQ cards + keywords added

AEO Readiness Score
100/100
Structured data present
Breadcrumb trail set
FAQ cards added
Featured image set
Meta description written
Excerpt set
Keywords added
Category assigned
🤝

Already using Yoast SEO, Rank Math, or All in One SEO?

No conflict — Masthead Pro automatically detects these plugins. If they're active, Masthead Pro steps back and lets them handle the basic meta description and social sharing tags, while it focuses on the structured data (schema), breadcrumbs, and FAQ cards that those plugins handle less well. You get the best of both.

What's Next

Three modules. One purchase.

Masthead Pro is being built in stages. Module 1 is live and ready. Modules 2 and 3 are already in development and will be delivered as free updates to everyone who purchases.

Schema & Visibility + AI

Live now · v1.1.0

Reading Experience

Coming · v1.2

Editorial Pipeline

Planned · v1.3

Module 1 · Live · v1.1.0

Schema & Visibility

Everything covered in this documentation — structured data, breadcrumbs, FAQ cards, Open Graph tags, the AEO score checker, and the one-click AI FAQ Generator with usage tracking.

Available now ✓

Module 2 · Coming v1.2

Reading Experience

An animated reading progress bar at the top of every article. Estimated read time displayed automatically. A table of contents generated from your headings. A "Read Next" panel at the end of each piece.

Free update for all buyers

Module 3 · Planned v1.3

Editorial Pipeline

A "Coming Soon" article grid for your blog index — showing upcoming pieces with status badges (Researching / Writing / Coming Soon). Makes your site feel like a living, active publication.

Free update for all buyers

Get Masthead Pro

Give your writing the
visibility it deserves.

$54

One-time payment  ·  All three modules included  ·  Free updates forever

Includes the one-click AI FAQ Generator — just bring your own Anthropic API key (typically less than $0.01 per article). No monthly fees, no subscriptions: pay once, and every future update — including Modules 2 and 3 — arrives free.

Sold via Gumroad  ·  Instant download  ·  30-day refund policy

Ko-fi Buy me a coffee
Scroll to Top