2026 Structured Data Blueprint

The Ultimate GeoCircle
Schema Generator

A GeoCircle is a GeoShape representing a circular geographic area. As it is a GeoShape it provides the simple textual property 'circle', but also allows the combination of postalCode alongside geoRadius. The center of the circle can be indicated via the 'geoMidpoint' property, or more approximately using 'address', 'postalCode'.

Includes:additionalTypeaddressaddressCountryalternateNameboxcircledescriptiondisambiguatingDescription+15 more
Instant JSON-LD Generation

Magic Build

Paste your URL below and our AI will automatically fill the GeoCircle fields for you.

Configuration

Live Generator

GeoCircle Schema

Fill in the fields below to generate your JSON-LD. Required fields are marked with *.

Required Fields

The name of the item. (Expects: Text)

Recommended

An image of the item. This can be a [[URL]] or a fully described [[ImageObject]]. (Expects: ImageObject, URL)

URL of the item. (Expects: URL)

Why use GeoCircle?

Structured data like GeoCircle markup helps search engines identify the most important details about your content instantly, improving your chances of earning rich results.

Output Panel

Awaiting input...

Want to automate this?

Connect your site to SchemaGen and our AI will automatically extract and deploy schemas for you. No manual coding required.

Launch AI Generator

What is GeoCircle Schema?

A GeoCircle is a GeoShape representing a circular geographic area. As it is a GeoShape it provides the simple textual property 'circle', but also allows the combination of postalCode alongside geoRadius. The center of the circle can be indicated via the 'geoMidpoint' property, or more approximately using 'address', 'postalCode'.

Why It Matters for SEO

Google uses GeoCircle structured data to understand the content and context of your pages. When correctly implemented, this schema can unlock rich results in Google Search — enhancing your listing with additional information that dramatically improves visibility and click-through rates.

Why Add GeoCircle Structured Data?

🔍

Appear in Rich Results

Structured data helps Google show enhanced results for your pages in search — including stars, prices, FAQs, and more.

📈

Boost Click-Through Rate

Rich snippets can increase CTR by up to 30% compared to plain search results — more clicks with the same ranking.

🤖

Feed AI Search Engines

AI answer engines like Perplexity and Google SGE use structured data to verify and cite facts from your content.

How to Implement GeoCircle JSON-LD

1

Generate

Use the form above to fill in your details and generate valid GeoCircle JSON-LD markup in seconds.

2

Copy

Copy the generated JSON-LD output code with one click — it's already formatted and ready to deploy.

3

Deploy

Paste the code into your <head> tag, or use SchemaGen's SDK to deploy without touching code.

Want to skip steps 2 & 3? Connect SchemaGen's SDK to deploy directly from the dashboard.

Properties You Can Include

GeoCircle schema supports the following schema.org properties. Required fields are the minimum Google needs to consider your markup valid; recommended fields unlock richer search result appearances.

PropertyDescriptionExpected TypeStatus
additionalTypeAn additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. Typically the value is a URI-identified RDF class, and in this case corresponds to the use of rdf:type in RDF. Text values can be used sparingly, for cases where useful information can be added without their being an appropriate schema to reference. In the case of text values, the class label should follow the schema.org style guide.Text, URLOptional
addressPhysical address of the item.PostalAddress, TextOptional
addressCountryThe country. Recommended to be in 2-letter [ISO 3166-1 alpha-2](http://en.wikipedia.org/wiki/ISO_3166-1) format, for example "US". For backward compatibility, a 3-letter [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) country code such as "SGP" or a full country name such as "Singapore" can also be used.Country, TextOptional
alternateNameAn alias for the item.TextOptional
boxA box is the area enclosed by the rectangle formed by two points. The first point is the lower corner, the second point is the upper corner. A box is expressed as two points separated by a space character.TextOptional
circleA circle is the circular region of a specified radius centered at a specified latitude and longitude. A circle is expressed as a pair followed by a radius in meters.TextOptional
descriptionA description of the item.Text, TextObjectOptional
disambiguatingDescriptionA sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation.TextOptional
elevationThe elevation of a location ([WGS 84](https://en.wikipedia.org/wiki/World_Geodetic_System)). Values may be of the form 'NUMBER UNIT\_OF\_MEASUREMENT' (e.g., '1,000 m', '3,200 ft') while numbers alone should be assumed to be a value in meters.Number, TextOptional
geoMidpointIndicates the GeoCoordinates at the centre of a GeoShape, e.g. GeoCircle.GeoCoordinatesOptional
geoRadiusIndicates the approximate radius of a GeoCircle (metres unless indicated otherwise via Distance notation).Distance, Number, TextOptional
identifierThe identifier property represents any kind of identifier for any kind of Thing, such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides dedicated properties for representing many of these, either as textual strings or as URL (URI) links. See [background notes](/docs/datamodel.html#identifierBg) for more details.PropertyValue, Text, URLOptional
imageAn image of the item. This can be a URL or a fully described ImageObject.ImageObject, URLRecommended
lineA line is a point-to-point path consisting of two or more points. A line is expressed as a series of two or more point objects separated by space.TextOptional
mainEntityOfPageIndicates a page (or other CreativeWork) for which this thing is the main entity being described. See [background notes](/docs/datamodel.html#mainEntityBackground) for details.CreativeWork, URLOptional
nameThe name of the item.TextRequired
ownerA person or organization who owns this Thing.Organization, PersonOptional
polygonA polygon is the area enclosed by a point-to-point path for which the starting and ending points are the same. A polygon is expressed as a series of four or more space delimited points where the first and final points are identical.TextOptional
postalCodeThe postal code. For example, 94043.TextOptional
potentialActionIndicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.ActionOptional

Example GeoCircle JSON-LD

Here's what valid GeoCircle structured data looks like with sample values filled in. Use the generator above to replace these with your own data.

Example Output
{
  "@context": "https://schema.org",
  "@type": "GeoCircle",
  "name": "Example GeoCircle",
  "image": "https://example.com/images/example.jpg",
  "url": "https://example.com/page",
  "additionalType": "Example additionalType",
  "address": {
    "@type": "PostalAddress",
    "name": "Example PostalAddress",
    "image": "https://example.com/images/example.jpg",
    "url": "https://example.com/page"
  },
  "addressCountry": "US",
  "alternateName": "Example alternateName",
  "box": "Example box"
}

Validate Your GeoCircle Schema

Once deployed, validate your schema is working correctly with our free audit tool. Paste your URL and we'll check for errors, missing properties, and Google Rich Result eligibility.

Free Schema Audit Tool →

Check your GeoCircle schema for errors and Rich Result eligibility