Brambyl — User Guide

How to diagnose, repair, and monitor your Google Search Console health — step by step.

1 Quick Start

Get from install to repaired in under 10 minutes.

Step 1 — Install & Activate

Step 2 — Connect Google Search Console

Step 3 — Run Your First Scan

Step 4 — Back Up, Then Repair

✓ That's the core loop Scan → Review → Repair → Verify. Everything else on this page is detail about how to do each step well and what happens behind the scenes.

2 The Complete Workflow

A. Connect & Scan

StepWhereWhat happens
Connect Google Search ConsoleSettings pageOAuth flow with Google. Plugin stores a refresh token locally. The webmasters scope grants full access — read data and submit sitemaps.
Select propertySettings pageMatch the Google Search Console property to this site (e.g. https://yoursite.com/).
Run ScanDashboard17 automated checks run against your database and live site. Findings appear with severity colors: 🔴 critical, 🟡 warning, 🔵 info.

B. Review Findings

Each finding shows: severity, a plain-English description, how many pages are affected, and sample URLs. The common findings and what they mean:

FindingSeverityWhat it meansWhat the repair does
Pages have is_public = NULL🔴 CriticalThese pages are silently excluded from your sitemap — Google never sees them.Sets the flag so pages enter the sitemap. Resubmit sitemap after this one.
Ambiguous noindex state (NULL)🟡 WarningYoast hasn't decided — Google may or may not index these pages.Sets explicit "indexable" state.
No canonical URL🟡 WarningGoogle guesses the canonical, sometimes wrong → duplicate content flags.Adds self-referencing canonicals.
Stale canonicals🟡 WarningCanonical points to an old/removed URL.Rewrites canonical to the current permalink.
Missing SEO title / meta description🟡 WarningGoogle writes its own title, usually worse CTR than a hand-written one.Not auto-repaired — needs content work (PRO flags it, you write the metas).
Sitemap noindex header🔴 CriticalYour sitemap itself is marked "noindex" — Google ignores the whole sitemap.Output-buffer repair that strips the header, survives SEO plugin updates.
Schema gaps🔵 InfoMissing JSON-LD structured data (WebSite, Organization).Guidance — usually needs theme/plugin work.

C. Apply Repairs

Repair tools require a PRO license. PRO is $95 USD/year for 1 site or $225 USD/year for up to 5 sites. The free tier ($0/forever) includes all 17 automated checks and monitoring — you can scan and review findings without a license; applying repairs requires PRO.

Repair All does the sitemap resubmit for you After applying database repairs, Repair All calls the sitemap resubmit automatically (when Google Search Console is connected). You only need to manually resubmit when running individual repair tools that change sitemap contents — see Section 4.

D. Verify

  1. Immediately: Re-run the scan. The repaired findings should disappear and the health score should rise.
  2. Check the sitemap: Open yoursite.com/sitemap_index.xml in your browser — the URL count should have grown (if is_public was repaired).
  3. In Google Search Console: Sitemaps → check "Discovered pages" on next Google fetch (up to 24h). Pages report buckets shift over 7–14 days.

3 Decision Flowchart

The complete lifecycle from install to healthy site:

Install & Activate Plugin
Connect Google Search Console
Run First Scan (17 checks)
Findings found?
YES
First-ever repair?
YES
Download backup (auto-sets ack)
Repair runs automatically
NO
Apply repairs (one or Repair All)
Repaired a sitemap-affecting issue?
(is_public, canonicals, sitemap header)
YES + used Repair All
Sitemap auto-resubmitted ✓
YES + individual repairs
Manually resubmit sitemap
(Settings → Resubmit Sitemap)
Re-run scan → confirm findings cleared
Wait 24–48h → check Google Search Console Sitemaps "Discovered pages"
Wait 7–14 days → check Google Search Console Pages report buckets
Site healthy — daily monitoring continues
NO
Site is healthy ✓
Daily monitoring continues automatically.
Weekly email report summarizes status.

4 When to Resubmit Your Sitemap

The rule: resubmit whenever your sitemap's contents changed in a way Google should know about immediately. Brambyl handles this automatically in most cases — here's the full picture:

✅ Automatic — No Action Needed

SituationWhy
You used Repair AllRepair All resubmits the sitemap automatically after database repairs (when Google Search Console is connected).
Publishing a new post/pageYoast updates the sitemap; Google picks it up on its normal crawl. The IndexNow integration (PRO) also pushes the new URL to Bing/Yandex/DuckDuckGo instantly.
Updating existing contentSame — lastmod changes, Google recrawls on schedule.

⚠️ Manual Resubmit Recommended

SituationHow
You applied individual repair tools (not Repair All) that affect sitemap contents — is_public repair, canonical repairs, sitemap noindex header repairBrambyl → Settings → Resubmit Sitemap (or re-run Repair All, which does it for you)
First-time connecting the plugin to a site with existing Google Search Console issuesSettings → Resubmit Sitemap after your first repair round
You migrated/changed URL structureSettings → Resubmit Sitemap after repairing canonicals
Google shows "Sitemap could not be read" or "0 discovered pages" in Google Search ConsoleRepair the underlying issue first (scan will tell you), then resubmit
Don't over-resubmit Resubmitting the same unchanged sitemap repeatedly does nothing — Google re-fetches on its own schedule. Resubmit when content changed, not on a calendar.

How to Resubmit in Brambyl

  1. Go to Brambyl → Settings
  2. Find the Sitemap section
  3. Click Resubmit to Google
  4. Confirm in Google Search Console → Sitemaps: "Last submitted" date should update within minutes, and "Discovered pages" populates after Google's next fetch

5 What Happens After a Repair — Realistic Timeline

Repairs apply to your database instantly, but Google's reactions take time. Here's what to expect and when to check:

Instant
Database changes are live. is_public flags set, canonicals written, noindex states resolved. Re-running the scan shows the findings cleared and your health score up. Your sitemap now contains the restored pages.
Minutes
Sitemap resubmission registers with Google. Google Search Console → Sitemaps shows the new "Last submitted" timestamp. (Google hasn't re-fetched yet — that's next.)
Up to 24 hours
Google re-fetches your sitemap. Check Google Search Console → Sitemaps → "Discovered pages" count. After an is_public repair, this number grows — that's Google seeing your restored pages for the first time.
1–7 days
Google crawls the newly discovered URLs. Pages enter "Discovered – currently not indexed" while Google evaluates them. Indexing depends on content quality, site authority, and crawl budget — new sites with few external links get indexed slowly.
7–14 days
Google Search Console Pages report buckets shift. "Excluded by noindex tag" and "Duplicate without canonical" shrink; indexed counts rise. This is where the SEO impact becomes measurable.
Patience is the hard part The plugin's job ends at "your site is technically correct and telling Google everything." How fast Google indexes and ranks depends on factors no plugin controls: content quality, external links, site age, and crawl budget. Brambyl clears the technical blockers — the content and authority work is yours.

6 Rollbacks & Safety

Three Layers of Protection

LayerWhat it coversHow to use
1. Pre-repair backupThe plugin's own tables (brambyl_findings, brambyl_fixes, brambyl_baselines, brambyl_data, brambyl_snapshots)Automatic on first repair — downloads before any change
2. Scoped rollback SQLThe exact rows each repair changed — captured at repair timeFix History → Revert button. Restores only what that repair touched, nothing else.
3. Your own full DB backupEverythingRecommended before your first repair round (host backup or a backup plugin)

When to Use Revert

Revert is safe: it restores the exact previous state of only the rows that repair changed — verified behavior: repair → revert → re-apply produces identical results.

Do not revert repairs from before a plugin update If Brambyl has since applied other repairs to the same rows, reverting an older repair may overwrite newer corrections. Check Fix History dates first — revert the newest relevant repair, not old ones.

7 FAQ

Q: Why can't I see any changes on my website?

A: The repairs are in metadata Google reads — canonical tags, indexable flags, sitemap contents. Nothing visible changes for human visitors. To verify: check your sitemap URL count, view-source a page for the canonical tag, and watch Google Search Console over the following days. The dashboard's health score and findings list are your in-plugin verification.

Q: The scan says "2,000+ pages missing SEO title or meta description" — will the repair write them?

A: No. Titles and descriptions are content decisions, not mechanical repairs. Brambyl flags them; you (or your SEO workflow) write them. The 7 repair tools handle flags, canonicals, and headers — not content.

Q: How often does monitoring run?

A: Daily (configurable in Settings). You'll get an email alert only when something changes for the worse, and a weekly summary report. Silence means healthy.

Q: Does this work with SEO plugins other than Yoast?

A: Yes — Rank Math, AIOSEO, SEOPress, and The SEO Framework are detected. Most database-level repairs target the Yoast indexable table; other plugins' equivalents are on the roadmap.

Q: What's the difference between the health score and Google Search Console's own reports?

A: GSC tells you what Google observed (lagged by days/weeks). Brambyl's scan tells you what's technically wrong right now in your database — and the repair tools address it immediately. Use both: apply repairs with the plugin, measure results in GSC.

Q: My Google Search Console shows 0 clicks and 0 impressions — is the plugin broken?

A: No. New or low-traffic sites genuinely have near-zero Google Search Console data. Click "Refresh GSC Data" (the button name) after 24–48h post-repair to pull fresh numbers. Indexing growth is a weeks-scale curve, not instant.