GHSA-7PW4-F3Q4-R2P2
Vulnerability from github – Published: 2026-07-20 23:21 – Updated: 2026-07-20 23:21Summary
When a transition:persist, transition:scope, or transition:persist-props directive is applied to a client-hydrated (client:*) component, Astro copied the directive value onto the rendered <astro-island> element without HTML-escaping it. If a developer reflects attacker-controlled input into one of these directives, an attacker can break out of the attribute and inject arbitrary HTML/JavaScript into the server-rendered output, resulting in reflected cross-site scripting (XSS).
Severity
Although a generic reflected XSS scores in the Medium range, exploitation here requires the application developer to have written a non-idiomatic pattern — passing untrusted, request-derived input directly into a transition directive. Astro applications that do not route untrusted input into these directives are unaffected. This mitigating precondition places the real-world severity at Low.
Details
In generateHydrateScript() (packages/astro/src/runtime/server/hydration.ts), every island property is HTML-escaped before serialization — the attrs, props, and opts assignments all pass through escapeHTML(). The transition directives, however, were copied verbatim:
transitionDirectivesToCopyOnIsland.forEach((name) => {
if (typeof props[name] !== 'undefined') {
island.props[name] = props[name]; // not escaped
}
});
The <astro-island> element is serialized via renderElement('astro-island', island, false) with shouldEscape=false, and toAttributeString() returns the value unchanged in that mode. As a result there is no downstream re-escaping, and the raw directive value reaches the HTML response. This is the same output sink previously addressed for slot names in GHSA-8hv8-536x-4wqp.
The affected directives are:
data-astro-transition-scope(transition:scope)data-astro-transition-persist(transition:persist)data-astro-transition-persist-props(transition:persist-props)
Note that transition:persist is typed boolean | string, so passing a string value is a supported use of the API.
Proof of Concept
A component that reflects a query parameter into a transition directive:
---
const persist = Astro.url.searchParams.get('persist') ?? 'default';
---
<Island client:load transition:persist={persist} />
Request:
https://example.com/?persist="><img src=x onerror=alert(document.domain)>
Rendered output (before the fix):
<astro-island … data-astro-transition-persist=""><img src=x onerror=alert(document.domain)>></astro-island>
The " closes the attribute and the injected <img onerror=…> executes in the victim's browser.
Impact
Reflected XSS. An attacker who can induce a victim to visit a crafted URL can execute arbitrary script in the victim's session on the origin, subject to the requirement that the target application reflects untrusted input into one of the affected transition directives.
Affected Versions
astro >= 3.10.0, < 7.0.4 (introduced in 3.10.0, PR #7861).
Patched Versions
astro >= 7.0.4. Fixed in PR #17212 by HTML-escaping transition directive values before they are rendered onto the island element.
Workarounds
Do not pass untrusted or request-derived input into transition:persist, transition:scope, or transition:persist-props. If such input is required, HTML-escape or strictly validate it before passing it to the directive. Upgrading to astro@7.0.4 or later removes the need for manual mitigation.
Credits
Reported by @jlgore.
{
"affected": [
{
"package": {
"ecosystem": "npm",
"name": "astro"
},
"ranges": [
{
"events": [
{
"introduced": "3.10.0"
},
{
"fixed": "7.0.4"
}
],
"type": "ECOSYSTEM"
}
]
}
],
"aliases": [
"CVE-2026-59727"
],
"database_specific": {
"cwe_ids": [
"CWE-116",
"CWE-79",
"CWE-83"
],
"github_reviewed": true,
"github_reviewed_at": "2026-07-20T23:21:02Z",
"nvd_published_at": null,
"severity": "LOW"
},
"details": "### Summary\n\nWhen a `transition:persist`, `transition:scope`, or `transition:persist-props` directive is applied to a client-hydrated (`client:*`) component, Astro copied the directive value onto the rendered `\u003castro-island\u003e` element **without HTML-escaping it**. If a developer reflects attacker-controlled input into one of these directives, an attacker can break out of the attribute and inject arbitrary HTML/JavaScript into the server-rendered output, resulting in reflected cross-site scripting (XSS).\n\n### Severity\n\nAlthough a generic reflected XSS scores in the Medium range, exploitation here requires the application developer to have written a non-idiomatic pattern \u2014 passing untrusted, request-derived input directly into a transition directive. Astro applications that do not route untrusted input into these directives are unaffected. This mitigating precondition places the real-world severity at Low.\n\n### Details\n\nIn `generateHydrateScript()` (`packages/astro/src/runtime/server/hydration.ts`), every island property is HTML-escaped before serialization \u2014 the `attrs`, `props`, and `opts` assignments all pass through `escapeHTML()`. The transition directives, however, were copied verbatim:\n\n```ts\ntransitionDirectivesToCopyOnIsland.forEach((name) =\u003e {\n if (typeof props[name] !== \u0027undefined\u0027) {\n island.props[name] = props[name]; // not escaped\n }\n});\n```\n\nThe `\u003castro-island\u003e` element is serialized via `renderElement(\u0027astro-island\u0027, island, false)` with `shouldEscape=false`, and `toAttributeString()` returns the value unchanged in that mode. As a result there is no downstream re-escaping, and the raw directive value reaches the HTML response. This is the same output sink previously addressed for slot names in GHSA-8hv8-536x-4wqp.\n\nThe affected directives are:\n\n- `data-astro-transition-scope` (`transition:scope`)\n- `data-astro-transition-persist` (`transition:persist`)\n- `data-astro-transition-persist-props` (`transition:persist-props`)\n\nNote that `transition:persist` is typed `boolean | string`, so passing a string value is a supported use of the API.\n\n### Proof of Concept\n\nA component that reflects a query parameter into a transition directive:\n\n```astro\n---\nconst persist = Astro.url.searchParams.get(\u0027persist\u0027) ?? \u0027default\u0027;\n---\n\u003cIsland client:load transition:persist={persist} /\u003e\n```\n\nRequest:\n\n```\nhttps://example.com/?persist=\"\u003e\u003cimg src=x onerror=alert(document.domain)\u003e\n```\n\nRendered output (before the fix):\n\n```html\n\u003castro-island \u2026 data-astro-transition-persist=\"\"\u003e\u003cimg src=x onerror=alert(document.domain)\u003e\u003e\u003c/astro-island\u003e\n```\n\nThe `\"` closes the attribute and the injected `\u003cimg onerror=\u2026\u003e` executes in the victim\u0027s browser.\n\n### Impact\n\nReflected XSS. An attacker who can induce a victim to visit a crafted URL can execute arbitrary script in the victim\u0027s session on the origin, subject to the requirement that the target application reflects untrusted input into one of the affected transition directives.\n\n### Affected Versions\n\n`astro \u003e= 3.10.0, \u003c 7.0.4` (introduced in 3.10.0, PR #7861).\n\n### Patched Versions\n\n`astro \u003e= 7.0.4`. Fixed in PR #17212 by HTML-escaping transition directive values before they are rendered onto the island element.\n\n### Workarounds\n\nDo not pass untrusted or request-derived input into `transition:persist`, `transition:scope`, or `transition:persist-props`. If such input is required, HTML-escape or strictly validate it before passing it to the directive. Upgrading to `astro@7.0.4` or later removes the need for manual mitigation.\n\n### Credits\n\nReported by @jlgore.",
"id": "GHSA-7pw4-f3q4-r2p2",
"modified": "2026-07-20T23:21:02Z",
"published": "2026-07-20T23:21:02Z",
"references": [
{
"type": "WEB",
"url": "https://github.com/withastro/astro/security/advisories/GHSA-7pw4-f3q4-r2p2"
},
{
"type": "WEB",
"url": "https://github.com/withastro/astro/pull/17212"
},
{
"type": "WEB",
"url": "https://github.com/withastro/astro/commit/7ba0bb1dc7516e88caff9abd7767322af44b0294"
},
{
"type": "PACKAGE",
"url": "https://github.com/withastro/astro"
},
{
"type": "WEB",
"url": "https://github.com/withastro/astro/releases/tag/astro@7.0.4"
}
],
"schema_version": "1.4.0",
"severity": [
{
"score": "CVSS:4.0/AV:N/AC:L/AT:P/PR:N/UI:A/VC:N/VI:N/VA:N/SC:L/SI:L/SA:N",
"type": "CVSS_V4"
}
],
"summary": "Astro: Cross-site scripting via unescaped transition:* directive values on hydrated islands"
}
Sightings
| Author | Source | Type | Date | Other |
|---|
Nomenclature
- Seen: The vulnerability was mentioned, discussed, or observed by the user.
- Confirmed: The vulnerability has been validated from an analyst's perspective.
- Published Proof of Concept: A public proof of concept is available for this vulnerability.
- Exploited: The vulnerability was observed as exploited by the user who reported the sighting.
- Patched: The vulnerability was observed as successfully patched by the user who reported the sighting.
- Not exploited: The vulnerability was not observed as exploited by the user who reported the sighting.
- Not confirmed: The user expressed doubt about the validity of the vulnerability.
- Not patched: The vulnerability was not observed as successfully patched by the user who reported the sighting.