Plugin Documentation

    Schema Manager Docs

    Everything you need to install, configure, and operate the DataStackLogic Schema Manager plugin for WordPress.

    What the plugin does

    Schema Manager covers the four blocks of structured data that AI engines and Google rely on to understand, trust, and cite your business.

    Organization

    Site-wide Organization JSON-LD with logo, social profiles, contact points, and parent-brand linking — the foundation every AI engine looks for first.

    LocalBusiness

    Per-location LocalBusiness markup with NAP, hours, geo-coordinates, and service areas — the markup Google Maps and Perplexity use to cite local results.

    FAQPage

    Structured Q&A blocks rendered as both on-page HTML and FAQPage JSON-LD — eligible for rich results and frequently surfaced verbatim by ChatGPT.

    AI Crawler Controls

    Hardened robots.txt and llms.txt with explicit allow rules for GPTBot, ClaudeBot, PerplexityBot, Google-Extended, and Applebot-Extended — plus a live visit log.

    Introduction

    DataStackLogic Schema Manager is a WordPress plugin that turns any WordPress site into an AI-discoverable knowledge source. It emits clean, validated JSON-LD that Google, ChatGPT, Perplexity, and Claude can parse to cite your business directly in answers.

    Unlike legacy SEO plugins that bolt schema on as an afterthought, Schema Manager is built from the ground up for Generative Engine Optimization (GEO). Every field maps to schema.org canon, every block is validated nightly, and every page is rendered server-side for zero performance overhead.

    Requirements

    Schema Manager runs on any modern WordPress host. Confirm your environment meets these minimums before installing.

    WordPress5.0 or later
    PHP7.4 or later (8.2+ recommended)
    MySQL5.6 or later (or MariaDB 10.1+)
    HTTPSRequired (TLS 1.2+)

    If you're unsure, your host's control panel or your developer can confirm these versions in under a minute.

    Installation

    Schema Manager can be installed two ways. Most users start with the WordPress.org search; teams running staged or air-gapped sites use the manual zip upload.

    Method 1 — Install from WordPress.org

    1. 1In your WordPress admin panel, go to Plugins → Add New.
    2. 2Search for "DataStackLogic Schema Manager".
    3. 3On the plugin card, click Install Now.
    4. 4When the button changes to Activate, click it.
    5. 5Confirm a new Schema Manager menu item now appears in the WordPress sidebar.

    Method 2 — Manual zip upload

    1. 1Download datastacklogic-schema-manager.zip from your DataStackLogic account dashboard.
    2. 2In WordPress admin, go to Plugins → Add New → Upload Plugin.
    3. 3Click Choose File, select the .zip you just downloaded, then click Install Now.
    4. 4Click Activate Plugin once the upload completes.
    5. 5(Optional) Install via WP-CLI on a server with shell access:
    wp plugin install datastacklogic-schema-manager.zip --activate

    Either method results in the same activated plugin. Continue to Quick Start to configure your Business Profile.

    Quick Start

    Four steps take a fresh install from activated to fully emitting validated JSON-LD on every public URL. Budget about ten minutes.

    Step 1 — Organization tab

    1. 1Open Schema Manager → Organization in the WordPress sidebar.
    2. 2Enter your legal business name, logo URL, and primary website URL.
    3. 3Add social profile URLs (LinkedIn, Facebook, X, YouTube) so AI engines can verify entity identity.
    4. 4Click Save Organization. Site-wide Organization JSON-LD is now live.

    Step 2 — Locations tab

    1. 1Open Schema Manager → Locations and click Add Location.
    2. 2Fill in NAP (name, address, phone), opening hours, and geo-coordinates for each branch.
    3. 3Assign each Location to its corresponding WordPress page from the Page dropdown.
    4. 4Save. Each assigned page now emits its own LocalBusiness JSON-LD.

    Step 3 — FAQ Pages tab

    1. 1Open Schema Manager → FAQ Pages and click Add FAQ Set.
    2. 2Add Q/A pairs for the page you want to mark up — keep answers under 300 words.
    3. 3Choose the target page from the Attach to Page dropdown.
    4. 4Save. The FAQ renders both as on-page HTML and FAQPage JSON-LD.

    Step 4 — Verify with View Source

    1. 1Open the published page in an incognito browser window.
    2. 2Right-click and choose View Page Source (or press Ctrl/Cmd + U).
    3. 3Search the source for application/ld+json — you should see one block per schema type emitted by Schema Manager.
    4. 4Paste any block into Google's Rich Results Test to confirm zero errors.

    Once all four steps verify clean, AI crawlers and Google will pick up the new schema on their next visit — typically within 24–72 hours.

    Organization Schema

    The Organization tab is the foundation of every other schema block. Fill these fields once and Schema Manager emits a complete Organization JSON-LD object site-wide.

    FieldDescription / FormatRequired
    Business NameLegal entity name as registeredRequired
    TypeOrganization, LocalBusiness, Corporation, etc.Required
    AddressFull street address, city, region, postal codeRequired
    PhoneE.164 format (+1 480 555 0123)Required
    EmailPublic contact email shown on About / ContactOptional
    LogoSquare PNG/SVG, min 112×112, served over HTTPSRequired
    Founding Year4-digit year (e.g. 2018)Optional
    Social ProfilesOne URL per line — LinkedIn, X, Facebook, YouTube, InstagramOptional
    NoteSocial profile URLs become the schema.org sameAs array — one of the strongest entity-verification signals AI engines use to confirm your business is real and to merge mentions across the web. Add every official profile you control.

    Locations

    Each branch, storefront, or service area should be its own Location entry. Schema Manager emits a dedicated LocalBusiness JSON-LD block on the page assigned to each Location, with NAP and hours consistent with your Organization profile.

    Add a location

    1. 1Open Schema Manager → Locations and click Add Location.
    2. 2Enter the branch name, full street address, phone (E.164 format), and email.
    3. 3Set opening hours, geo-coordinates, and service area (see the formats below).
    4. 4Assign the Location to the WordPress page or custom post that represents this branch.
    5. 5Click Save Location — JSON-LD is now live on the assigned URL.

    Opening hours format

    Hours follow the schema.org openingHours convention — comma-separated ranges using two-letter day codes (Mo, Tu, We, Th, Fr, Sa, Su) and 24-hour times.

    Mo-Fr 09:00-17:00, Sa 10:00-14:00

    Use multiple lines for split shifts (e.g. lunch closures): Mo-Fr 09:00-12:00, Mo-Fr 13:00-17:00.

    Geo coordinates from Google Maps

    1. 1Open google.com/maps and search for the branch address.
    2. 2Right-click the exact pin location on the map.
    3. 3Click the first menu item — the latitude,longitude pair (e.g. 33.1942,-111.5347) copies to your clipboard.
    4. 4Paste into the Latitude and Longitude fields, splitting on the comma. Six decimal places is enough.

    Custom post type support

    By default, Locations can attach to standard Pages and Posts. To enable attachment to a custom post type (e.g. branch, store, clinic), open Schema Manager → Settings → Post Types and tick the relevant CPTs. The Location dropdown on the metabox refreshes immediately.

    CPTs registered with public => false are excluded automatically — Schema Manager never emits JSON-LD on non-public URLs.

    CSV import

    For chains with 10+ branches, import every Location at once via Schema Manager → Locations → Import CSV. The first row must be a header. Use the format below:

    name,street,city,region,postal_code,country,phone,email,latitude,longitude,opening_hours,page_slug
    Phoenix Downtown,101 N Central Ave,Phoenix,AZ,85004,US,+14805550101,phx@example.com,33.4484,-112.0740,"Mo-Fr 09:00-17:00",locations/phoenix-downtown
    Mesa East,4400 E Main St,Mesa,AZ,85205,US,+14805550102,mesa@example.com,33.4152,-111.6710,"Mo-Sa 08:00-18:00",locations/mesa-east
    Gilbert HQ,2200 S Gilbert Rd,Gilbert,AZ,85295,US,+14805550103,gilbert@example.com,33.3528,-111.7890,"Mo-Fr 09:00-17:00, Sa 10:00-14:00",locations/gilbert-hq
    NoteWrap any field that contains a comma in double quotes — opening_hours almost always needs them. Imports run as a dry-run preview first; nothing publishes until you confirm.

    FAQ Pages

    FAQPage schema is the single highest-leverage block for AI citation. ChatGPT, Perplexity, and Google's AI Overviews all surface FAQPage answers verbatim when they match a user's question.

    Assign FAQPage schema to a page

    1. 1Open the WordPress page or post you want to mark up in the editor.
    2. 2Scroll to the Schema Manager metabox below the content area.
    3. 3From the Schema Type dropdown, choose FAQPage.
    4. 4Click Apply — the FAQ entry table appears inside the metabox.
    5. 5Update or publish the page; FAQPage JSON-LD is now emitted on that URL.

    Add Q&A pairs

    1. 1In the FAQ entry table, click Add Question.
    2. 2Type the question exactly as a customer would phrase it (full sentence, ends in a question mark).
    3. 3Write a complete, self-contained answer in the Answer field — see the citation note below.
    4. 4Repeat for each Q&A pair. Drag the handle on the left to reorder.
    5. 5Click Update on the WordPress post to save. The same Q&A renders as on-page HTML and as JSON-LD.
    NoteWrite answers that stand alone. AI engines lift FAQPage answers as a single block — they will not stitch context from elsewhere on the page. Aim for 40–300 words per answer, include the business name or product name in the first sentence, and avoid pronouns that depend on the question ("it", "they", "this"). Complete answers get cited; partial answers get skipped.

    Pro tier: bulk-import FAQ pairs from a CSV or auto-generate them from page content using the DataStackLogic GEO model.

    Financial Product Pages

    For banks, credit unions, lenders, and fintechs, Schema Manager ships dedicated templates for each schema.org financial product type. Apply the matching template from the Schema Manager metabox on any product or rate page.

    Schema TypeBest for
    AutoLoanNew, used, and refinance vehicle loan products with APR, term, and down-payment requirements.
    MortgageLoanFixed and ARM mortgage products including loan-to-value, points, and amortization period.
    CreditCardConsumer and business credit card products with APR, annual fee, rewards, and intro offers.
    BankAccountChecking, savings, and money market accounts with monthly fees, minimum balance, and APY.
    InvestmentOrDepositCertificates of deposit, IRAs, and investment products with yield, term, and minimum deposit.
    LoanOrCreditPersonal loans, lines of credit, and any other lending product not covered above.
    NotePick the most specific type that fits — AutoLoan over LoanOrCredit, CreditCard over LoanOrCredit. Google and Perplexity reward type specificity in financial verticals where compliance disclosures matter.

    AI Crawlers

    Schema Manager generates a hardened robots.txt and llms.txt that explicitly allow GPTBot, ClaudeBot, PerplexityBot, Google-Extended, and Applebot-Extended while blocking known scraper bots.

    The Crawlers dashboard logs every AI bot visit with timestamp, URL, and user agent — so you can prove citation-readiness to stakeholders.

    GEO Score & Grading

    Schema Manager assigns every site a 0–100 GEO Score based on how completely you've implemented the schema blocks AI engines weight most heavily. The score recalculates after every save and is shown on the main dashboard.

    Scoring breakdown

    CategoryMax points
    Organization30 pts — complete Organization profile with logo, NAP, and sameAs profiles
    Locations20 pts — every public branch page has its own LocalBusiness block with hours and geo
    FAQ Pages25 pts — FAQPage schema applied to high-intent pages with self-contained answers
    Product Pages15 pts — correct schema.org product or financial type applied to product/rate pages
    AI Crawlers10 pts — robots.txt and llms.txt explicitly allow major AI bots; visit log active

    Letter grade scale

    GradeScore range
    A90–100 — citation-ready across every major AI engine
    B80–89 — strong coverage with one or two gaps to close
    C70–79 — foundational schema present; missing one full category
    D60–69 — partial implementation; AI engines will cite competitors first
    FBelow 60 — minimal or invalid schema; not citation-ready
    NoteAim for an A. Anything under 80 leaves citation share on the table — AI engines preferentially quote the highest-completeness source on a topic, not the highest-traffic one.

    Dashboard Sync

    Connect your WordPress install to the DataStackLogic dashboard at app.datastacklogic.com to track your GEO Score, citation log, and AI crawler visits across every site you manage from one place.

    Connect a site in 3 steps

    1. 1In WordPress, open Schema Manager → Connect and click Generate Token. Copy the token to your clipboard.
    2. 2Sign in at app.datastacklogic.com, open Sites → Add Site, paste the token and your site URL, then click Sync Now.
    3. 3Back in WordPress on the Connect tab, click Sync Now — the dashboard populates within a few seconds.
    NoteSync runs automatically every 6 hours after the first manual sync. Use Sync Now any time you want an immediate refresh after publishing schema changes.

    Uninstall & Data

    By default, deactivating or uninstalling Schema Manager preserves all of your schema data, location records, FAQ pairs, and connection settings. Reinstall the plugin and everything is exactly where you left it — no re-entry, no lost configuration.

    Delete data on uninstall

    If you need a clean removal (for example, retiring a site or migrating to a fresh install), open Schema Manager → Tools → Danger Zone and tick Delete all plugin data on uninstall. The next time the plugin is uninstalled, every related table, option, and cached payload is purged.

    WarningThis action is irreversible. Once the checkbox is enabled and the plugin is uninstalled, your Organization profile, locations, FAQ schemas, product schemas, and dashboard connection token cannot be recovered. Export your data from Tools → Export first if you might need it later.

    Changelog

    Recent releases. Schema Manager auto-updates from the DataStackLogic license server when a valid key is present under Schema Manager → License.

    v1.9.1 — current

    • Fixed a rare race condition when syncing FAQ schema to the dashboard on multisite installs.
    • Improved AI crawler detection for GPTBot, PerplexityBot, and ClaudeBot user agents.
    • Hardened nonce checks on the Connect tab token generator.

    v1.9.0

    • New: Financial product schema templates (AutoLoan, MortgageLoan, CreditCard, BankAccount, InvestmentOrDeposit, LoanOrCredit).
    • New: GEO Score now factors AI crawler access into the 100-point total.
    • Dashboard sync payload reduced by ~40% via incremental diff transport.

    v1.8.4

    • Fixed CSV import for locations when opening hours contained commas.
    • Resolved a PHP 8.3 deprecation notice in the schema renderer.

    v1.8.3

    • Added FAQPage schema assignment per post and per custom post type.
    • Added Tools → Danger Zone with the delete-on-uninstall checkbox.
    • Improved compatibility with Yoast SEO 23.x JSON-LD output.

    FAQ

    Need a hand?

    Our architects install and configure Schema Manager for you as part of every Architecture Audit engagement.

    Book a Free Audit