Top-level storage access (requestStorageAccessFor)
Lets a top-level page request cookie access on behalf of related embedded sites.
In one line
Can ask Chrome to let related embedded sites use their cookies, if you allow
Lets a top-level page request cookie access on behalf of related embedded sites.
Allows a page to unlock third-party cookies for sites in the same Related Website Set. Chrome only and deprecated; its use hints at cross-site identity joining.
What it can and can't do
What the user does: You tap a button on the page, then answer the Chrome prompt if one appears.
It can
- Ask for cookie access for related sites embedded in the page
- Skip the prompt when the sites are in the same Related Website Set
- Use that access after you allow it
It cannot
- Do it in Firefox or Safari
- Reach unrelated sites
- Get access if you choose Block
How it differs between platforms: Chrome and Edge only. Firefox and Safari do not have it.
Browser support
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 119 | 2023-10-31 | Deprecated |
| Edge | Supported | 119 | 2023-11-02 | None |
| Firefox | Not supported | Not available | Not listed | None |
| Safari | Not supported | Not available | Not listed | None |
| Safari on iPhone | Not supported | Not available | Not listed | None |
| Chrome on Android | Supported | 119 | 2023-10-31 | None |
| Samsung Internet | Not supported | Not available | Not listed | None |
How a site asks for it
| API | document.requestStorageAccessFor(origin); permission top-level-storage-access |
| Permission name | top-level-storage-access |
| Browser compat keys | api.Document.requestStorageAccessFor |
| How access is granted | prompt |
| What the user sees | Chrome only: prompt unless the sites are in the same Related Website Set. |
| Needs a secure context (HTTPS) | Yes |
| Needs a user gesture | Yes |
| How long it lasts | Per top-level site |
| How to take it back | Site settings |
| Inside an iframe | Not applicable |
Typical flow
- User gesture on top-level page
- requestStorageAccessFor('https://embed.example')
- Chrome checks Related Website Set
- Embedded requests then carry cookies
Data you get
What comes back: Grant outcome
Shape: boolean
How often: one-shot
No individual data fields. The signal is the access itself.
Technical limits
- Same Related Website Set only
- Chrome only, deprecated
The story
What it is
Lets a main page ask the browser to share cookies with its related embedded sites.
For you
You might see a prompt asking if related sites can share your sign in. Say yes and it works smoothly across a company's brands. Say no and you may need to log in again.
For makers
It helps companies with several linked sites keep one sign in. It is a narrow path that browsers allow for related sites only. It is not meant for general ad tracking.
Where you see it
| Type | Example | Apps |
|---|---|---|
| enterprise | A company with several brand sites lets one login work across all of them. | None named |
| shopping | A store group shares your cart and login between its regional shops. | None named |
| media | A media company keeps a subscription active across its linked news sites. | None named |
| games | A game publisher keeps one account across its game and community sites. | None named |
| payments | A payment provider recognises you across a merchant's linked checkout sites. | None named |
| ads | An ad firm hopes to use it for tracking, but browsers limit it to closely related sites. | None named |
Risks
- Cross site data sharing
- Easy to approve by habit
What the platform says
- MDN: requestStorageAccessFor. Documents a call that lets a top level site request cookie access on behalf of related embedded sites.
Good uses and abuse
Legitimate uses
- Brand-owned sites sharing sessions
Known abuse
- Cross-site identity joining
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 3 of 5 | How revealing the data is |
| Utility | 2 of 5 | How useful it is to honest apps |
| Friction | 2 of 5 | How much the user has to do |
| Fingerprint bits | Not rated | Rough identifying entropy, when known |
History
- 2023-10, Chrome 119: requestStorageAccessFor ships with Related Website Sets
Related capabilities
Related
- Storage Access API. Can ask to get its own cookies back when shown inside another site
Sources
How well checked: Based on official documentation.