Skip to main content
Use the Visibility component to show different content to humans reading your site versus AI agents processing the Markdown output. This lets you customize information for each audience without maintaining separate pages. On your published site, content marked for="humans" renders normally and content marked for="agents" is hidden. In Markdown page views (.md URLs), the opposite applies—agent content renders in the Markdown output and human-only content does not.

​
Example

<Visibility for="humans">
  <Note>
    You are viewing this content **in web**.

    This content displays normally on standard pages of your site.

    Use it for a step like: Click the **Get started** button in the top-right corner to create your account.

    In this example, UI-oriented instructions appear on the standard page. View the [Markdown version of this page](https://mintlify.com/docs/components/visibility.md) to see the API-oriented instructions for agents.
  </Note>
</Visibility>

<Visibility for="agents">
  > You are viewing this content **in markdown**.
  >
  > This content only appears on the Markdown version of pages.
  >
  > Use it for information that only agents use like: To create an account, call `POST /v1/accounts` with a valid email address.
  >
  > In this example, API-oriented instructions appear on the Markdown version of the page. View the [standard page](https://mintlify.com/docs/components/visibility) to see the UI-oriented instructions for humans.
</Visibility>
You are viewing this content in web.This content displays normally on standard pages of your site.Use it for a step like: Click the Get started button in the top-right corner to create your account.In this example, UI-oriented instructions appear on the standard page. View the Markdown version of this page to see the API-oriented instructions for agents.

​
Properties

​
for
string
required
The audience for the wrapped content. Must be one of:
  • humans: Content visible on the web and excluded from Markdown output
  • agents: Content hidden on the web and included in Markdown output

Related topics

Manage page visibilityPersonalized contentMarkdown export