Skip to content
Customer Support

Support Center

Welcome to the Blue Ninja Systems Support Center. Find direct answers to your questions about Authority Infrastructure™, get step-by-step guides, explore learning paths, and submit a ticket if you need hands-on help.

Schema guidance by page type (FAQPage vs HowTo vs Article)

Conceptual schema strategy for support content page types with truth-safe implementation guardrails.

Outcome statement

By the end of this guide, you will be able to choose the appropriate schema pattern for each support page type and avoid common mismatches between page intent and markup strategy.

Overview

Schema is most useful when it matches page purpose and visible structure. Applying markup without intent alignment often creates inconsistent signals and adds maintenance burden.

In Authority Infrastructure, schema decisions are tied to the content model:

  • Answer Hub pages are question-first and may map to FAQ-like structures when appropriate.
  • KB guides are workflow-oriented and often map to HowTo or Article-like structures.
  • Category and overview pages generally follow collection/list intent.

This guide is conceptual and implementation-oriented. It does not provide legal or platform policy guarantees.

Step-by-step workflow

Step 1: Classify page intent first

Before touching schema, identify primary page intent:

  • direct question resolution
  • stepwise workflow execution
  • broader explanatory article
  • category or collection navigation

Step 2: Map intent to primary schema candidate

Use a practical mapping:

  • FAQ-style answer clusters -> FAQPage candidate
  • procedural task walkthroughs -> HowTo candidate
  • long-form explanatory content -> Article candidate

If a page has mixed intent, split content before selecting markup.

Step 3: Align visible structure with schema

Ensure headings and body structure reflect markup intent:

  • FAQ-like pages should clearly show Q/A structure.
  • HowTo-like pages should show ordered steps and prerequisites.
  • Article-like pages should prioritize explanatory narrative.

Step 4: Keep one primary schema intent per page

Avoid stacking multiple conflicting schema types by default. Over-tagging can reduce clarity and raise maintenance complexity.

Step 5: Pair schema with linking strategy

Schema alone is insufficient. Pair it with:

  • clear parent-category links
  • related answer links
  • next-step guide/path links

This supports contextual continuity for users and systems.

Step 6: Validate after publishing

Use your QA process to confirm:

  • required fields present
  • no obvious syntax errors
  • schema intent matches visible content
  • links and metadata are consistent

Step 7: Monitor and refine

When content structure changes, schema should be revisited. Outdated schema often appears after page rewrites.

Step 8: Document schema decisions

For each page type, maintain a lightweight internal rubric:

  • when to use
  • when not to use
  • required visible structure
  • approval owner

Decision points

  • If page mixes FAQ and workflow: split into answer page + guide page.
  • If workflow is incomplete: use Article-like structure first, then upgrade to HowTo when steps are stable.
  • If Q/A is sparse: avoid FAQPage-style schema and use simpler article patterns.
  • If team lacks technical support: prioritize content clarity first and phase schema implementation.

Examples

Example 1: Direct question page

Title: “Do I need a developer to implement Authority Infrastructure?”

Intent: direct answer with decision guidance.

Schema approach: FAQ-like intent may fit if page remains Q/A-focused.

Example 2: Workflow guide

Title: “How to build a topic map from repeated customer questions”

Intent: ordered implementation workflow.

Schema approach: HowTo-like intent may be suitable when explicit steps and prerequisites are present.

Example 3: Conceptual explainer

Title: “What does AI-ready support content mean?”

Intent: explanatory education with examples.

Schema approach: Article-like intent may be more appropriate than HowTo.

Common mistakes

  • Mistake: Applying FAQPage-style markup to non-FAQ pages.

Safer approach: require visible Q/A structure before using FAQ-like schema.

  • Mistake: Treating schema as a one-time setup.

Safer approach: re-validate when content changes.

  • Mistake: Overloading one page with multiple schema intents.

Safer approach: split page by intent and apply one primary schema direction.

  • Mistake: Ignoring internal links while focusing only on markup.

Safer approach: pair schema with linking and IA quality checks.

FAQ

Q: Should every support page have schema? A: Not necessarily. Start where page intent is clear and template stability is high.

Q: Is FAQPage always best for Answer Hub pages? A: No. Some answer pages are better modeled as Article-like content depending on format and intent.

Q: Can one page use both HowTo and FAQPage? A: It is generally safer to keep one primary intent per page and split content when mixed.

Q: Does schema guarantee inclusion in rich features or AI outputs? A: No. Schema improves structured clarity but does not guarantee external outcomes.

Related guides/answers

Related KB guides

Supporting answers

Learning paths

Implementation worksheet

Use this worksheet to move from reading to execution.

Inputs to collect

  • Current support taxonomy and existing page inventory.
  • Repeated-question sources (tickets, chat, calls, docs feedback).
  • Existing ownership model and publishing controls.
  • Constraints (time, technical support, scope boundaries).

Outputs to produce

  • Updated IA/intent map for this workflow.
  • Prioritized execution tasks with owner and due date.
  • QA checklist updates for links, structure, and schema intent.
  • Change log entries documenting what changed and why.

Governance checklist

Before marking this workflow complete:

  • Confirm all linked answer pages are still accurate.
  • Confirm associated learning path steps remain in valid order.
  • Confirm review cadence and owner assignment are documented.
  • Confirm claims remain truth-safe and non-guaranteed.
  • Confirm downstream teams understand handoff expectations.

Operational handoff package

At handoff, provide:

  • summary of decisions made,
  • unresolved risks and assumptions,
  • pages requiring follow-up updates,
  • and the next planned review checkpoint.

This preserves continuity when ownership shifts or scope expands.

Extended execution examples

Example execution pass: first 14 days

  • Day 1-2: confirm scope, owners, and success criteria.
  • Day 3-5: execute first workflow pass on highest-frequency intents.
  • Day 6-8: run quality checks for links, structure, and clarity.
  • Day 9-11: resolve gaps identified in review.
  • Day 12-14: publish updates and document follow-up backlog.

Example execution pass: next 30 days

  • Run one structured refresh cycle.
  • Compare new support questions with existing coverage.
  • Add missing pages only when intent cannot be covered by existing assets.
  • Archive or merge low-value duplicate pages.

Quality gate before completion

Before marking this guide complete:

  • Confirm downstream users can execute the workflow without implicit tribal knowledge.
  • Confirm related answer links still represent the same current process.
  • Confirm at least one owner can run the workflow independently.
  • Confirm unresolved risks are documented with next review date.

Final validation pass

Before closing this guide as complete, run one final validation loop:

  • walk through the workflow with a teammate who did not write it,
  • confirm they can execute without hidden assumptions,
  • and update any unclear steps immediately.

This last pass often catches ambiguity that structured reviews miss.

Quick reinforcement

If this workflow will be reused by additional team members, run one shadow execution where a second owner follows the documented process end to end. Record where they pause, what assumptions were unclear, and which linked pages required clarification. Update the guide/path immediately so future execution is smoother and less dependent on tribal knowledge.