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

**GEO Schema Optimization** is an agent in Mark (Optimizely Agent Platform). It analyzes page content and generates or refines JSON-LD schema markup directly within Optimizely Content Management System (CMS 13). 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 13 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

The GEO Schema Optimization agent requires Optimizely CMS 13.

## 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.](docId\:pe0pbUJveWrG8ewvZWDRE)
:::

Install the agent from the **Directory**.

1. Go to **Directory > Agents**.
2. (Optional) Enter *GEO Schema Optimization* or use the drop-down list filters to narrow the list.
3. Click **Install** on the **GEO Schema Optimization** agent with the ID `@geo_schema_optimization-paas` to add it to your Mark instance.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/42-cRmKExIZriDpelslwu_image-4.png)

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

## Use the agent

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

Before you use the **GEO Schema Optimization** agent, you must install the Mark tools in your CMS 13 instance. See [Get started with Mark tools](docId\:OFb83kQNema_apcEoryfJ) for information.
:::

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

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

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

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

## Default agent details

These are the default details for the **GEO Schema Optimization** agent. After you [install the agent in your Mark instance](docId\:lfHb-UolEi9PhlSCLjL1b), 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:

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

CMS 13 automatically shares the input variables with Mark when using Mark chat from within CMS 13.

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`
- `paas_cms_get_content_data`
- `paas_cms_get_content_type_details`
- `paas_cms_create_content_type`
- `paas_cms_update_content_type`
- `paas_cms_update_content_item`
- `paas_cms_create_content_item`

You must install the Mark tools in your CMS 13 instance before using the **GEO Schema Optimization** agent. See [Get started with Mark tools](docId\:OFb83kQNema_apcEoryfJ) for information.

### Default configuration

The agent uses the following default configuration:

- **Inference level** – Complex, which 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).
:::