Schema & JSON-LD

JSON-LD (JavaScript Object Notation for Linked Data) is a structured data format that you embed in your HTML to describe your page's content in a way that search engines and AI systems can parse programmatically.

Rather than guessing what your page is about, search engines read your JSON-LD to understand the type of content (article, product, FAQ, etc.), its properties, and how it relates to other entities.

When you run a scan, Align parses every JSON-LD block on the page and lists each schema it finds along with its @type value. For example, a blog post might contain Article and Organization schemas.

The Schema tab displays the detected types in a list so you can quickly see what structured data is already present.

Based on your page type and content, Align suggests missing schema types that could improve your search visibility. Each recommendation includes a priority level:

• High — strongly recommended. These schemas are expected for your page type and have a direct impact on rich results.
• Medium — beneficial. Adding these schemas can improve how search engines and AI systems interpret your content.
• Low — optional but helpful. These provide additional context but are not critical.

Align does not just tell you what is missing — it can generate the recommended schemas for you. When a recommendation is shown, Align pre-builds a valid JSON-LD block using the metadata it already extracted from your page (title, description, images, and more).

You can review the generated schema before taking any action. No code is added to your site until you explicitly create a pull request.

To add recommended schemas to your site:

• Select the schema recommendations you want to apply in the action panel.
• Click Create PR.
• Align opens a pull request on your linked GitHub repository that inserts the JSON-LD blocks into the appropriate pages.

Review the PR diff, merge when ready, and your structured data is live. See the Creating Pull Requests guide for the full workflow.

These are the most common JSON-LD schema types that Align detects and recommends:

• Organization — identifies your company or brand.
• WebPage — describes a generic web page and its properties.
• Article — marks blog posts, news articles, and editorial content.
• FAQPage — enables the FAQ rich result in Google search.
• HowTo — structures step-by-step instructional content.
• Product — describes products with pricing, availability, and reviews.
• LocalBusiness — provides location, hours, and contact details for local businesses.
• BreadcrumbList — defines the breadcrumb navigation path for your page.