---
title: ConsentGate
description: Shared ConsentGate reference for the c15t Vue plugin and Nuxt module.
group: reference
lastModified: "2026-10-10T14:59:21+01:00"
lastAuthor: Kaylee
---
## What ConsentGate renders

`ConsentGate` renders its default slot while the visitor's effective
permission for `category` is granted, and its `placeholder` slot otherwise.
It adds no wrapper element. While permission is denied, the default slot
does not exist in the DOM, so an iframe or widget inside it sends no
requests. When the visitor withdraws permission, Vue removes the slot
content.

Permission is the same value `useConsent()` returns for the category. It can
be granted under an opt-out policy before the visitor has recorded a choice,
and a privacy signal such as Global Privacy Control can deny a category the
visitor granted.

Without a `placeholder` slot, the gate renders the same placeholder as the
React and Svelte gates. It shows the `consentGate.title` text with the
category name, and a button labelled with `consentGate.actionButton` that
opens the preference dialog. Under a strict policy that leaves the category
out, no choice can allow the content, so the placeholder shows
`consentGate.policyBlocked` and no button. The text is in the visitor's
language once init has delivered copy, and in English until then. The
placeholder is a card styled by your theme tokens and the
`--consent-gate-placeholder-*` variables. A `placeholder` slot replaces it
entirely.

To restyle the built-in placeholder instead, set its parts under
`components['consent-gate']` in the options. `root` is the card, and
`title` and `button` are its text and button. Use Vue attribute names such as `class` and `style`. The
`consentGate`, `consentGateTitle` and `consentGateButton` theme slots reach
the same parts. The placeholder carries
`data-testid="consent-gate-placeholder"`, its title
`data-testid="consent-gate-title"` and its button
`data-testid="consent-gate-button"`.

`ConsentGate` also adds its `category` to the categories the preference
dialog lists, so the button opens a dialog where the visitor can allow it.

## Props and slots

|Name|Kind|Type|Behavior|
|--|--|--|--|
|`category`|Prop, required|`'necessary' \|'functionality' \|'measurement' \|'experience' \|'marketing'`|The category whose permission gates the default slot.|
|`default`|Slot||The gated content, such as an iframe.|
|`placeholder`|Slot||Shown while the category is denied.|

## Accessibility

Give the iframe a descriptive `title`. Keep a way to reach the content
without the embed, such as a link or a transcript, for visitors who decline
the category. A policy can fix a category as denied, so opening preferences
does not guarantee the visitor can allow it.