---
title: GEO Schema Optimization agent (CMS SaaS)
slug: agent-platform/docs/geo-schema-optimization-agent
docTags: 
createdAt: 2026-08-12T15:37:05.000Z
---

**GEO Schema Optimization** is an agent in Agent Platform. It analyzes page content and generates or refines JSON-LD schema markup directly within Optimizely Content Management System (SaaS). The markup improves search engine comprehension and AI search visibility.

- **Challenge** – Structuring Generative Engine Optimization (GEO)-specific content correctly with schema markup is complex. This often leads to under-optimized local search performance and missed opportunities for rich search results.
- **Agent outcome** – The agent analyzes your CMS (SaaS) content and external URLs for GEO-related schema and identifies gaps. It then automatically adds or populates JSON-LD with accurate, real content to enhance local Search Engine Optimization (SEO).
- **Value** – Improves visibility in local search results, increases the likelihood of displaying in rich snippets, and drives more relevant local traffic.

## Required Optimizely products

Optimizely Content Management System (SaaS)

## Install agent

:::hint{type="info"}
**Note**

**Mark Administrators**, **Agent Builders**, and users with the **Add, edit, and install specialized agents** attribute for a custom role can add agents to their organization's Mark instance. See [Add users and set permissions.](../../get-started/get-started-with-optimizely-opal-for-administrators.mdx)
:::

Install the agent from the **Directory**.

1. Go to **Directory > Agents**.
2. (Optional) Begin entering *GEO Schema Optimization* or use the drop-down list filters to narrow the list.
3. Click **Install** on **GEO Schema Optimization** to add it to your Mark instance.

   ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/PNFu1f9GGfIFOMyBd7Tlg-20260720-144945.png)

If **Install** is disabled, ensure the [Required Optimizely products](docId\:dBYmWD2J_568MBo2tdaGS) are connected to your Mark instance.

## Use the agent

In [Mark chat](docId\:dtNBEttEGVvkhNkwNypLM), enter *@geo\_schema\_optimization* and provide the following details:

- `ContentKey` – Enter the content key for the current CMS (SaaS) page.
- `ContentVersion` – Enter the version of the current CMS (SaaS) page.
- `PreviewURL` – Enter the preview URL for the current CMS (SaaS) page.
- (Optional) `SchemaProperty` – Enter the schema property from CMS (SaaS), if available.

The agent analyzes the page content, generates or refines JSON-LD schema markup, and updates the schema property in CMS (SaaS) directly.

To use the **GEO Schema Optimization** agent in a [workflow agent](docId:2HD0fUsIsfdek516VtN9l), drag and drop it into your workflow. See [Create a workflow agent](docId\:KWaI2TBwD38sN7p74exoy).

## Details

These are the default details for the **GEO Schema Optimization** agent. After you [install the agent in your Mark instance](docId\:dBYmWD2J_568MBo2tdaGS), customize these details for your organization's needs. See [Manage agents](docId\:SSeNiblVMXwVvDR_lhtvI) for instructions.

### Input variables

The **GEO Schema Optimization** agent takes the following input:

CMS (SaaS) automatically shares the input variables with Mark when using Mark chat from within CMS (SaaS).

When using Mark chat from the Mark app interface, enter these values directly.

- `ContentKey`
- `ContentVersion`
- `PreviewURL`
- (Optional) `SchemaProperty`

### Tools

The **GEO Schema Optimization** agent uses the following tools internally to process your request:

- `browse_web_html`
- `cms_get_content_data`
- `cms_get_content_type_details`
- `cms_create_content_type`
- `cms_update_content_type`
- `cms_update_content_item`
- `cms_create_content_item`

### Additional details

The agent uses the following default configuration:

- **Inference level** – Complex. Provides advanced reasoning and detail.
- **Files** – None.
- **Output** – Text.

:::hint{type="info"}
**Note**

If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See [Turn generative AI off across Optimizely applications](docId\:X5U0kKD2azV5cIdNqwGNj).
:::