Skip to content

Add respect-site-support param to callout shortcode#37486

Open
hestonhoffman wants to merge 2 commits into
masterfrom
heston/callout-site-support
Open

Add respect-site-support param to callout shortcode#37486
hestonhoffman wants to merge 2 commits into
masterfrom
heston/callout-site-support

Conversation

@hestonhoffman

@hestonhoffman hestonhoffman commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

What does this PR do? What is the motivation?

See:

Adds a respect-site-support boolean parameter (default true) to the callout shortcode.

It's confusing to users when we show a banner stating that a feature is unsupported along with a separate banner inviting them to try the feature out in preview. This setting uses the existing unsupported_sites config in params.yaml to hide preview callouts for regions that are listed as unsupported. You can set respect-site-support to false to ignore site-support.

For an example, see Dynamic Metric Quotas. The preview callout should disappear on the gov sites and the site-support warning should appear.

Merge instructions

Merge readiness:

  • Ready for merge

Additional notes

To opt out on a specific callout: {{< callout respect-site-support="false" ... >}}

When a preview callout appears on a page that is also listed in
unsupported_sites, the two banners contradict each other. The new
respect-site-support param (default true) wraps the callout in the
existing site-region-container mechanism so it is hidden from readers
on unsupported sites, matching the per-site behavior of the automated
banner.

Reuses get_unsupported_regions.html and .Site.Params.allowedRegions —
no JS changes, no params.yaml changes.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@hestonhoffman hestonhoffman requested a review from a team as a code owner June 12, 2026 18:17
@github-actions github-actions Bot added the Architecture Everything related to the Doc backend label Jun 12, 2026
Announcement and informational callouts (New: Bill Overview, Key
Information, Suppression evaluation) should always be visible
regardless of site restrictions, so opt them out of the default
respect-site-support behavior.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@hestonhoffman hestonhoffman requested a review from a team as a code owner June 12, 2026 20:21
@github-actions github-actions Bot added the Guide Content impacting a guide label Jun 12, 2026
@evazorro evazorro added the editorial review Waiting on a more in-depth review label Jun 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Architecture Everything related to the Doc backend editorial review Waiting on a more in-depth review Guide Content impacting a guide

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants