JSON-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 links —
isRelatedTomaps upsell offers configured on each offer as related alternativesAdd-on offers — when enabled, add-ons from
useCampaign()are attached to each subscription offer using the schema.orgaddOnpropertyCheckout deep links —
checkoutPageURLTemplateandurlon each Offer, pointing to Limio purchase links so agents can link directly to checkoutAttribution 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-results) or Schema validation (https://validator.schema.org/).
Configuration
The component is configured via props in the Limio Page Builder. The base props control the schema type and product metadata:
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
Purchase links and UTM attribution
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.
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 agentscheckoutPageURLTemplate— 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 systemsutm_medium=llm— identifies the channel as a large language modelutm_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.
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?
Last updated
Was this helpful?

