Custom metadata (2)

Last updated Aug 6, 2026 You can attach custom metadata to web pages using HTML <meta> tags. AI Search extracts metadata from the <head> section of each crawled page.

Before custom metadata can be extracted, you must define a schema in your AI Search configuration.

Add metadata to web pages

Add <meta> tags using either the name or property attribute:

<!DOCTYPE html>
<html>
    <head>
        <meta name="title" content="Getting Started Guide" />
        <meta name="description" content="Learn how to set up the application" />
        <meta property="og:title" content="Getting Started Guide" />
        <meta property="og:image" content="https://example.com/og-image.png" />
        <meta name="category" content="documentation" />
        <meta name="version" content="2.5" />
        <meta name="is_public" content="true" />
    </head>
    <body>
        <!-- Page content -->
    </body>
</html>

Recognized fields

For the following fields, AI Search knows which meta tags to extract from. You must still define these in your schema to enable extraction.

When both a standard meta tag and an Open Graph tag are present, the standard meta tag takes precedence.

How metadata extraction works

When the crawler fetches a page:

1. All <meta> tags with name or property attributes are parsed from the <head> section.
2. Tag names are matched against your schema (case-insensitive).
3. The content attribute value is cast to the configured data type.
4. Extracted metadata is stored alongside the cached HTML.
5. On subsequent processing, metadata flows into the vector index.

Boolean value parsing

For boolean fields, the following values are accepted (case-insensitive):

Any other value is treated as invalid and the field is omitted.

Was this helpful?

YesNo

On this page

Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/ai-search/configuration/data-source/website/custom-metadata/#page","headline":"Custom metadata","description":"Extract metadata from the HTML meta tags on crawled pages so you can filter search results by it.","url":"https://developers.cloudflare.com/ai-search/configuration/data-source/website/custom-metadata/","inLanguage":"en","image":"https://developers.cloudflare.com/ai-search/configuration/data-source/website/custom-metadata/og.png?v=41c470ba57c4a01e","dateModified":"2026-08-06","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: Choose how AI Search finds pages on a website data source. title: Parse types image: https://developers.cloudflare.com/ai-search/configuration/data-source/website/parse-types/og.png?v=dc672d4a9c0f7582

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/ai-search/llms.txt
Use this file to discover all available pages before exploring further.