codeJSON-LD Schema (AEO / GEO)

Generates Schema.org JSON-LD structured data from your Limio pricing pages and embeds it as a <script type="application/ld+json"> in the page head at publish time. Includes Product, Offer, and Price definitions, upsell links (isRelatedTo), add-on offers, and checkout deep links with UTM attribution for AI agent tracking.

How it works

At publish time, Limio reads the offers on your pricing page and converts them into Schema.org JSON-LD. The schema includes:

  • Product and Offer definitions — mapping directly from Limio's domain model (Product, Offer, Price use the same terminology as Schema.org)

  • Upsell linksisRelatedTo maps upsell offers configured on each offer as related alternatives

  • Add-on offers — when enabled, add-ons from useCampaign() are attached to each subscription offer using the schema.org addOn property

  • Checkout deep linkscheckoutPageURLTemplate and url on each Offer, pointing to Limio purchase links so agents can link directly to checkout

  • Attribution tracking — UTM parameters (utm_source=ai&utm_medium=llm) baked into checkout URLs so you can measure whether AI agents actually drive purchase traffic

The component is added to your pricing page like any other Limio component. Once published, you can verify the output using Google's Rich Results test (https://search.google.com/test/rich-resultsarrow-up-right) or Schema validation (https://validator.schema.org/arrow-up-right).

Configuration

The component is configured via props in the Limio Page Builder. The base props control the schema type and product metadata:

Prop
Type
Default
Description

schemaType

picklist

SoftwareApplication

Schema.org type: SoftwareApplication, Product, or Service

applicationName

string

""

Product or application name

applicationUrl

string

""

Product or application URL

applicationCategory

string

BusinessApplication

Application category (SoftwareApplication only)

pageDescription

string

""

Page-level description for the schema

includeAddOns

boolean

false

Include cross-sell add-ons in the schema output

To enable checkout deep links and attribution tracking, configure the purchase link props. These use Limio's standard purchase link format (/checkout?purchase=/offers2/offerName) and append UTM parameters so you can measure AI-driven traffic in your analytics.

Prop
Type
Default
Description

shopDomain

string

""

Your shop domain (e.g. https://shop.example.com). Required to enable purchase links — leave empty to omit them.

checkoutBasePath

string

/checkout

The checkout page path. Change this if your checkout uses a custom page tag.

utmSource

string

ai

UTM source parameter for attribution

utmMedium

string

llm

UTM medium parameter for attribution

utmCampaign

string

limio-pricing-page

UTM campaign parameter for attribution

When shopDomain is set, each Offer in the JSON-LD output includes two fields:

  • url — a direct purchase link for the offer, widely supported by search engines and AI agents

  • checkoutPageURLTemplate — the same link using the Schema.org v15 property specifically designed for checkout URLs

The offer path (/offers2/offerName) is derived automatically from the offer data returned by useCampaign().

Example output for a single offer:

Measuring AI attribution

Once deployed, you can track whether AI agents and LLMs are driving purchase traffic by filtering your analytics for the UTM parameters:

  • utm_source=ai — identifies traffic originating from AI systems

  • utm_medium=llm — identifies the channel as a large language model

  • utm_campaign=limio-pricing-page — identifies the specific pricing page

These defaults are designed for general AI attribution. You can customise them per page — for example, setting utmCampaign to enterprise-pricing on your enterprise page to distinguish traffic sources.

The purchase links follow Limio's standard purchase link format, so they work with all existing checkout configurations including promo codes (&pc=PROMO123).

Why it matters

AI agents and LLMs increasingly rely on structured data to understand and recommend products. Without JSON-LD, your pricing pages are invisible to these agents — or worse, misrepresented by stale third-party data.

This is an experiment to test a hypothesis: does publishing structured offer data lead to AI-driven purchase traffic? The UTM tracking lets you answer that question directly. If agents start sending traffic to your checkout, you'll see it in your order data.

Schema.org types map almost 1:1 to Limio's domain model, making the integration lightweight. One schema, two delivery formats — pages get embedded JSON-LD, and a future feed endpoint could serve the same data for direct agent consumption.


circle-info

This is a Labs feature. We're experimenting with this and it's not yet part of the core platform. Interested in early access or want to help shape it?

Request access →envelope

Last updated

Was this helpful?