Straight answers. No Schmarrn.
FAQ
Getting Started
Do I need coding skills?
Not at all. Install it like any WordPress plugin — upload, activate, done. Everything is configured through the standard WordPress admin. No PHP, no command line, no config files.
What are the requirements?
WordPress 6.0+ and PHP 8.0+. Most hosting providers have been on PHP 8.x for a while — this shouldn't be an issue. If you're unsure, your host's control panel shows the PHP version.
Does it work with Gutenberg and the Classic Editor?
Both. The meta description meta box and GEO Quick Overview meta box appear in both editors. BreznGEO uses standard WordPress meta boxes, which are editor-agnostic.
Do I need an API key to use it?
No. BreznGEO works without an API key. In that case it uses a built-in fallback: it extracts the first 150–160 characters from your post content using sentence-boundary detection. No AI involved, but your posts always get a description.
Can I use it on multiple sites?
Yes. BreznGEO is GPL-licensed, so you can install it on as many sites as you own or manage. Each site uses its own API key and settings independently.
AI & Meta Generation
Which AI providers are supported?
OpenAI (GPT-4.1, GPT-4o, GPT-4o mini), Anthropic Claude (3.5 Sonnet, 3 Haiku), Google Gemini (2.0 Flash, 1.5 Pro), and xAI Grok (3, Grok 3 mini). You can switch providers at any time from the settings — no reinstall required.
How much does AI generation actually cost?
Very little. A single meta description is roughly 150–200 tokens — fractions of a cent per post. Even processing 500 posts in bulk, the total API cost is typically under €1. You pay your provider directly; BreznGEO takes nothing.
Check your provider's pricing page for exact numbers — they vary by model.
Will BreznGEO overwrite meta descriptions I wrote myself?
No. If a post already has a meta description — whether you wrote it or another plugin set it — BreznGEO leaves it alone. It only generates when the field is empty, unless you explicitly click the regenerate button in the post editor.
Does it work alongside Rank Math or Yoast SEO?
Yes. BreznGEO automatically detects Rank Math, Yoast SEO, AIOSEO, and SEOPress and writes AI-generated descriptions directly into their meta fields. Your SEO plugin of choice stays in control — BreznGEO just fills in the content.
What happens if the API call fails?
BreznGEO falls back to its built-in text extraction — the same sentence-boundary fallback that runs without an API key. Your post always gets a description, even if the AI provider is temporarily unavailable.
Can I customise the AI prompt?
Yes, fully. The prompt is editable in Settings → Meta Generator. Available placeholders: {title}, {content}, {excerpt}, and {language}. Tune the tone, target length, or language for your audience.
GEO Quick Overview
What is "GEO" and why should I care?
GEO stands for Generative Engine Optimization — the practice of structuring your content so AI systems like ChatGPT, Perplexity, and Claude can read, understand, and cite it accurately.
Traditional SEO targets search engine crawlers. GEO targets the AI models that are increasingly replacing search as the first point of contact between readers and content.
What exactly does the GEO Quick Overview block generate?
Three things: a short summary of your post, a bullet-point list of key takeaways, and an optional FAQ section — all generated from your post content. It appears inside your post as a collapsible <details> block. Fully editable, no JavaScript required on the frontend.
Will the GEO block slow down my site?
No. The block outputs plain HTML — a native <details> element with static text. No JavaScript is loaded on the frontend. It's as fast as a regular paragraph.
What's the auto-lock feature?
If you manually edit the AI-generated summary, bullets, or FAQ in the post editor, BreznGEO automatically locks that post. On the next save or publish, the AI won't overwrite your edits. You can unlock it manually in the meta box at any time.
Does the GEO block appear on every post automatically?
By default, yes — on every post that meets the word-count threshold (default: 350 words). You can disable it per post via the meta box in the editor, or switch the generation mode to manual-only in the global settings.
Internal Link Suggestions
What are Internal Link Suggestions and why do they matter for SEO?
Internal links — links from one of your posts to another on the same site — are one of the strongest on-page SEO signals. They help search engines map your site structure, distribute page authority, and understand topical relevance. They also keep readers on your site longer.
The problem: finding the right phrase in your current post and the right target page is slow, manual work. BreznGEO does it automatically while you write.
Does it insert links automatically, without asking me?
No. BreznGEO only suggests — you decide. The editor sidebar shows a list of phrase → target post pairs ranked by relevance. You tick the ones you want and click confirm. Links are then inserted at the first unlinked occurrence of each phrase. Nothing is touched without your explicit approval.
Do I need an AI API key for Link Suggestions to work?
No. The core matching runs entirely without an AI key, using keyword overlap and n-gram phrase scoring. If you have an API key configured and have enabled "Link Suggestions" in the AI Features card on the Dashboard, the top candidates are optionally re-ranked by your AI provider for improved semantic relevance. AI re-ranking is an optional upgrade — off by default, enabled per feature in the Dashboard.
Isn't this a paid feature in most SEO plugins?
Yes — that's exactly the point. Internal link suggestion is typically locked behind premium tiers in tools like LinkWhisper ($77/year), Surfer SEO, or Yoast Premium. BreznGEO includes it for free, with no subscription and no upsell. It's one of the features that makes BreznGEO genuinely competitive with paid tools.
How does it decide which posts to suggest as link targets?
BreznGEO tokenises your current post content and scores every published post against it using four weighted signals: title keyword overlap (×3, highest), tag overlap (×2), post excerpt overlap (×1.5), and category overlap (×1). Each candidate's title + tags + excerpt + categories together form its "topic". BreznGEO then finds the best phrase in your current text that shares a word with that topic — so a post about the Danube can correctly link to a Deggendorf post if "Deggendorf" carries "danube" as a tag and the word "danube" appears in your article, even if "Deggendorf" itself never does. Posts you've excluded in the Link Suggestions settings are never shown. Posts you've boosted rank higher when they match.
Schema & Structured Data
What is structured data and why does it matter?
Structured data (Schema.org JSON-LD) is machine-readable metadata embedded invisibly in your page. Google uses it for rich results — star ratings, recipe cards, FAQ dropdowns in search. AI engines use it to understand context, authorship, and content type. It's invisible to readers, very visible to algorithms.
Which schema types does BreznGEO support?
14 types: Organization, Article / BlogPosting, Author (Person), ImageObject, VideoObject (auto-detected from YouTube/Vimeo embeds), FAQPage (auto-generated from GEO block data), Speakable, BreadcrumbList, HowTo, Review, Recipe, and Event. Each type can be enabled or disabled independently.
Will BreznGEO's schema conflict with Rank Math or Yoast?
No. BreznGEO detects active SEO plugins and automatically suppresses BreadcrumbList output when Rank Math or Yoast is active — since they already handle that type. Other schema types from BreznGEO complement rather than duplicate what those plugins output.
Do I need to fill in schema data manually for every post?
For the automatic types (Organization, BlogPosting, BreadcrumbList, Author) — no. They pull from your site settings and post meta automatically.
For post-specific types (Recipe, HowTo, Review, Event) — yes, you fill them in once per post via the BreznGEO Schema meta box in the post editor. It only appears when at least one of these types is enabled in settings.
Compatibility
Does BreznGEO work with WooCommerce?
BreznGEO focuses on posts and pages. It does not generate meta descriptions or schema for WooCommerce products. If you need product SEO, use a dedicated WooCommerce SEO plugin alongside BreznGEO — they won't conflict.
Does it work on WordPress Multisite?
BreznGEO can be network-activated on a Multisite installation, but settings are per-site. Each site in the network manages its own API key, provider choice, and configuration independently.
Is it compatible with caching plugins like WP Rocket or W3 Total Cache?
Yes. BreznGEO generates meta tags and JSON-LD in the <head> at request time on the server side. There is nothing on the frontend that caching would interfere with. Caching plugins will simply cache the output, which is exactly the intended behaviour.
Does it work with Elementor, Divi, or other page builders?
Yes. BreznGEO hooks into post save and publish events at the WordPress level, independent of which editor or builder was used to create the content. Meta descriptions and schema are attached to the post object, not to the builder's content structure.
Security & Privacy
Where are my API keys stored?
API keys are XOR-encrypted with a key derived from your WordPress authentication salts before being written to the database. The salts are unique per installation, so the encrypted value is useless outside your site. Keys are never stored in plain text and never appear in logs.
Does BreznGEO send my post content to third parties?
Only to the AI provider you configured — and only when you trigger a generation. Your post title and content are sent as part of the prompt to OpenAI, Anthropic, Google, or xAI, whoever you chose.
No data is ever sent to BreznGEO, Donau2Space.de, or any third party beyond your chosen AI provider. Your provider's standard data processing terms apply.
Does it collect data about my visitors?
The Crawler Log records visits from known AI bots (GPTBot, ClaudeBot, etc.). It stores: the bot name, a SHA-256 hash of the IP address (the original IP is never stored and cannot be recovered), the URL visited, and the timestamp. Entries are automatically deleted after 90 days. Human visitor data is never collected.
Is BreznGEO GDPR / DSGVO compliant?
BreznGEO itself does not collect personally identifiable information. The Crawler Log stores only hashed IPs — not reversible to real addresses. Your AI provider's data processing agreement (DPA) covers the content sent for generation. Standard practice is to name your AI provider in your site's privacy policy.
Licensing & Future
Is it really free? What's the catch?
No catch. BreznGEO is GPL-2.0 licensed and free to use. The only cost is your AI API usage, billed directly by your provider. There is no freemium model, no feature gating, no premium tier, and no upsell emails. Prost.
Will it stay free?
That's the intention. BreznGEO was built because I didn't want to pay a monthly SaaS fee for my own blog. That motivation hasn't changed. If new features get added, they go into the free plugin — not behind a paywall.
Can I use it on client sites?
Yes. GPL-2.0 allows installation on any number of sites. There are no licence checks, activation limits, or per-site fees. Each client site needs its own API key from the provider of their choice.
Will there ever be a Pro version?
No current plans for a paid tier. The model is simple: BreznGEO stays free, you pay your AI provider directly. That's it.
Where do I report bugs or request features?
Open an issue at github.com, use the WordPress.org support forum.