nuxt-x-affiliate
Article Disclosure
FTC 16 CFR §255.5 in-content snippet — sits at the top of every review or article page in-flow with the article typography.
Article Disclosure
FTC 16 CFR §255.5 requires that disclosures be "in close proximity" to the affiliate claim. The XAFArticleDisclosure component is the in-content snippet that sits at the top of every review / article page, in-flow with the article typography — separate from a buy button's own disclosure.
Components
<XAFArticleDisclosure />
<XAFArticleDisclosure
published-at="2026-01-15"
updated-at="2026-04-20"
/>
Props
| Prop | Type | Default | Description |
|---|---|---|---|
text | string | from xAffiliateContent.disclosure.text | Override the disclosure body text. |
link | string | 'https://x.enterprises/legal/affiliate-disclosure' | Override the link URL. |
linkLabel | string | 'Read our full disclosure policy' | Override the link label. |
publishedAt | string (ISO YYYY-MM-DD) | — | First-published date. |
updatedAt | string (ISO YYYY-MM-DD) | — | Last-updated date. Only rendered if it differs from publishedAt. |
locale | string | 'en-US' | Locale for date formatting. Dates are UTC-pinned for SSR stability. |
Accessibility
Renders with role="note" and aria-label="Affiliate disclosure" so screen readers announce it clearly at the top of the article.
SSR stability
Dates are parsed and formatted in UTC regardless of server/client timezone, so the rendered output is identical on the server and during hydration — no hydration mismatches.
Examples
At the top of every review page
<template>
<article>
<XAFArticleDisclosure
:published-at="review.publishedAt"
:updated-at="review.updatedAt"
/>
<h1>{{ review.title }}</h1>
<XAFStarRating :rating="review.rating" variant="hero" show-scale />
<!-- ... rest of article ... -->
</article>
</template>
Global config (set once)
export default defineAppConfig({
xAffiliateContent: {
disclosure: {
text: 'This article contains affiliate links. We may earn a commission at no extra cost to you.',
},
},
})
AI Context
component: XAFArticleDisclosure
package: "@xenterprises/nuxt-x-affiliate"
use-when: >
At the top of every review or article page that contains affiliate
links. Satisfies FTC 16 CFR §255.5 "close proximity" requirement with
role="note" and aria-label="Affiliate disclosure". Optional Published
and Updated dates — Updated is hidden when it equals Published. Dates
are UTC-pinned for SSR stability. Link points to the canonical legal
disclosure page (override via app.config.ts or the link prop).