---
description: Extract metadata from the HTML meta tags on crawled pages so you can filter search results by it.
title: Custom metadata
image: https://developers.cloudflare.com/og-docs.png
---
[Skip to content](#main-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.
# Custom metadata
Last updated Aug 24, 2026|Copy as Markdown|[View as Markdown](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/ai-search/configuration/data-source/website/custom-metadata/index.md)|[Agent setup](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/agent-setup/)
You can attach custom metadata to web pages using HTML `` tags. AI Search extracts metadata from the `` section of each crawled page.
Before custom metadata can be extracted, you must [define a schema](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/ai-search/configuration/indexing/metadata/#define-a-schema) in your AI Search configuration.
## Add metadata to web pages
Add `` tags using either the `name` or `property` attribute:
```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.
| Field | Source |
| ----------- | ------------------------------------------------------------- |
| title | or |
| description | or |
| image | |
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 `` tags with `name` or `property` attributes are parsed from the `` 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):
| True values | False values |
| ------------ | ------------ |
| true, 1, yes | false, 0, no |
Any other value is treated as invalid and the field is omitted.
Was this helpful?
YesNo
## On this page
[Docs](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/)
```json
{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/ai-search/configuration/data-source/website/custom-metadata/#page","headline":"Custom metadata ยท Cloudflare AI Search docs","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/og-docs.png","dateModified":"2026-08-24","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/"}}
```