Skip to content

Instantly share code, notes, and snippets.

@mary-ext
Last active July 31, 2025 20:17
Show Gist options
  • Save mary-ext/6e27b24a83838202908808ad528b3318 to your computer and use it in GitHub Desktop.
Save mary-ext/6e27b24a83838202908808ad528b3318 to your computer and use it in GitHub Desktop.
Bluesky's UK age assurance sucks, here's how to work around it.

Bluesky's UK age assurance sucks, here's how to work around it.

Bluesky recently announced that they're complying with the UK's Online Safety Act, which requires users to provide personal identity verification confirming their age (through Epic Games' Kids Web Services) before accessing certain parts of the platform.

This sucks for privacy reasons, but thankfully there are ways to work around it.

Workaround methods

Method 0. VPN

This was obvious, but using a VPN to connect from outside the UK will bypass the age assurance requirements entirely.

If you don't already have one, a VPN routes your connection through servers in other countries and prevents your ISP from tracking and selling your browsing data, though you're essentially trading trust from your ISP to your VPN provider instead.

My personal recommendations are Mullvad, IVPN or ProtonVPN.

Don't fall for VPN services that heavily focus on marketing, especially if they market features like "military-grade encryption" or make exaggerated privacy claims.

Method 1. Third-party clients

You don't have to use the official Bluesky app to access the platform. Third-party clients like Klearsky or TOKIMEKI currently don't implement these restrictions. For read-only access without signing in, Anartia is also available.

Note that these alternatives work only as long as their developers don't implement similar age assurance measures or block UK users outright (and as the person behind Anartia, I have no plans to implement such thing.)

Method 2. Custom adblock filter rules

You can add the following filter rules to your adblocker.

||bsky.app/ipcc$replace=/(?<="isAgeRestrictedGeo":)true/false/

! Optional, if Bluesky ever adds regional content moderation to UK users
||bsky.app/ipcc$replace=/(?<="countryCode":").+?(?=")/US/

for uBlock Origin (Firefox)

  1. Open uBlock Origin dashboard › My filters
  2. Enable Enable my custom filters
  3. Enable Allow custom filters requiring trust
  4. Add the rules provided above

for Brave browser (Desktop, Android)

  1. Open Settings › Shields › Content filtering
  2. Enable Developer mode
  3. Add the rules provided above to Create custom filters

for Adguard (Firefox)

  1. Open Adguard Settings › User Rules
  2. Make sure it's enabled
  3. Add the rules provided above

for Adguard (Android)

Note: Custom filter rules is a paid feature on the Android version.

Based on testing, this seems to produce wonky results. The setup process is also more complex. But if it works, it allows you to use Bluesky's Android app as usual.

  1. Create a text file containing the filter rules provided above and save it to somewhere accessible
  2. Open Adguard and navigate to Settings › Filtering › Filters › Custom Filters › Add custom filter
  3. Tap Browse and locate the text file you created
  4. Select the file to add it as a custom filter list

Method 3. Custom DNR rules (Chrome)

Chrome recently introduced breaking changes to their extension platform in the form of Manifest v3, the biggest change involves restricting primarily ad blockers by removing webRequest API in favor of declarativeNetRequest API. It's not quite powerful, but it's good enough for our needs.

And as it turns out, uBlock Origin Lite allows you to add custom declarativeNetRequest (DNR) rules.

  1. Open uBlock Origin Lite dashboard
  2. Enable Developer mode
  3. Head to Develop › View: Custom DNR rules
  4. Insert the following rules:
---
priority: 1
action:
  type: redirect
  redirect:
    url: https://gist.githubusercontent.com/mary-ext/6e27b24a83838202908808ad528b3318/raw/ipcc-response.json
condition:
  requestDomains:
    - bsky.app
  initiatorDomains:
    - bsky.app
    - main.bsky.dev
  urlFilter: /ipcc
  resourceTypes:
    - xmlhttprequest
---
priority: 1
action:
  type: redirect
  redirect:
    url: https://gist.githubusercontent.com/mary-ext/6e27b24a83838202908808ad528b3318/raw/getAgeAssuranceState-response.json
condition:
  initiatorDomains:
    - bsky.app
    - main.bsky.dev
  urlFilter: /xrpc/app.bsky.unspecced.getAgeAssuranceState
  resourceTypes:
    - xmlhttprequest
---

Method 4. Userscripts and Brave scriptlets

You can use userscripts, or scriptlets in Brave.

for userscript extensions

  1. Install a userscript manager

  2. Install this userscript

for Brave browser (Desktop)

Open Settings › Shields › Content filtering (or go to about:adblock)

Enable Developer mode, and add the following scriptlet, saving it as user-bsky-age-assurance.js.

const _fetch = globalThis.fetch;
globalThis.fetch = async function (req, init) {
  if (req instanceof Request) {
    const url = new URL(req.url);

    switch (url.pathname) {
      case "/xrpc/app.bsky.unspecced.getAgeAssuranceState": {
        return Response.json({
          lastInitiatedAt: "2025-07-14T14:22:43.912Z",
          status: "assured",
        });
      }
    }
  } else if (req === "https://bsky.app/ipcc") {
    return Response.json({
      countryCode: "US",
      isAgeRestrictedGeo: false,
    });
  }

  return _fetch.call(this, req, init);
};

Then reference the scriptlet in a custom filter.

bsky.app##+js(user-bsky-age-assurance.js)
main.bsky.dev##+js(user-bsky-age-assurance.js)

Method 5. Self-hosted PDS

If your account is hosted on a PDS you own or control, you can add these rules to your Nginx or Caddy configuration.

for Nginx users:

server {
	server_name pds.example.com;

	location /xrpc/app.bsky.unspecced.getAgeAssuranceState {
		default_type application/json;
		add_header access-control-allow-headers "authorization,dpop,atproto-accept-labelers,atproto-proxy" always;
		add_header access-control-allow-origin "*" always;
		return 200 '{"lastInitiatedAt":"2025-07-14T14:22:43.912Z","status":"assured"}';
	}
}

for Caddy users:

pds.example.com {
	handle /xrpc/app.bsky.unspecced.getAgeAssuranceState {
		header content-type "application/json"
		header access-control-allow-headers "authorization,dpop,atproto-accept-labelers,atproto-proxy"
		header access-control-allow-origin "*"
		respond `{"lastInitiatedAt":"2025-07-14T14:22:43.912Z","status":"assured"}` 200
	}
}

Background

Bluesky's implementation of age-based content restrictions is entirely client-side, this is an intentional design decision. The API (called the "AppView") doesn't impose content restrictions directly and isn't aware of your UK location as requests are proxied through your account's hosting server (called the "PDS").

bsky.app (or the "client") checks your location by making a request to https://bsky.app/ipcc, which returns:

  • countryCode: your country based on IP address, which is used for regional content moderation.
  • isAgeRestrictedGeo: whether your country mandates identity verification

When isAgeRestrictedGeo is true, it will then make a request to <pds host>/xrpc/app.bsky.unspecced.getAgeAssuranceState, which returns:

  • status: your account's current verification status
  • lastInitiated: when you last started the identity verification process

These workarounds exploit the client-side nature of these checks.

Worth noting that decentralized social networks aren't above the law. All platforms, including Mastodon and other federated networks, must comply with local regulations like the Online Safety Act, and a fully decentralized network may need individual server operators to handle compliance.

It remains unclear whether UK regulators would consider Bluesky's client-side implementation sufficient for OSA compliance. However, Bluesky Social PBC could reasonably argue the restrictions are effectively enforced for users on their PDS using unmodified clients, and that's as far as they can guarantee in a decentralized network like Bluesky.

I am not a lawyer however.

What you can do next

While these workarounds provide immediate relief, consider taking action to address the root cause:

Support the petition to repeal the Online Safety Act

There's an ongoing petition to the UK Parliament calling for the repeal of the Online Safety Act. If you're a UK citizen or resident, consider signing it to show opposition to these privacy-invasive measures.

Contact your MP

Reach out to your Member of Parliament to express concerns about the Act's impact on privacy and digital rights. You can find your MP and their contact details on the UK Parliament website.

// ==UserScript==
// @name Bluesky age assurance bypass
// @version 1.0
// @match https://bsky.app/*
// @match https://main.bsky.dev/*
// @grant none
// @run-at document-start
// ==/UserScript==
const _fetch = globalThis.fetch;
globalThis.fetch = async function (req, init) {
if (req instanceof Request) {
const url = new URL(req.url);
switch (url.pathname) {
case "/xrpc/app.bsky.unspecced.getAgeAssuranceState": {
return Response.json({
lastInitiatedAt: "2025-07-14T14:22:43.912Z",
status: "assured",
});
}
}
} else if (req === "https://bsky.app/ipcc") {
return Response.json({
countryCode: "US",
isAgeRestrictedGeo: false,
});
}
return _fetch.call(this, req, init);
};
{
"lastInitiatedAt": "2025-07-14T14:22:43.912Z",
"status": "assured"
}
{
"countryCode": "US",
"isAgeRestrictedGeo": false
}
@mary-ext
Copy link
Author

mary-ext commented Jul 24, 2025

Hrmm, you're using uBlock Origin on Chrome? I wonder if it's because it's not supported there, I don't have an old copy of Chrome laying around so I can't test this for you sorry.

I am not sure why it isn't working for you on Firefox though, could you close all the tabs, and then restart the browser?

@dangerousdriver
Copy link

Must be another extension in Chrome - got working in FF with only uBlock active.

@tulpenkiste
Copy link

tulpenkiste commented Jul 24, 2025

Theres also this extension which can be used for bypassing. Works well for me on Zen (firefox)

@stucka
Copy link

stucka commented Jul 24, 2025

Yesterday I launched Chrome for the first time in ages and discovered uBlock Origin no longer works, but the same person makes uBlock Origin Lite; I don't know if that allows for the same kind of filtering.

@kiri-thornalley
Copy link

kiri-thornalley commented Jul 24, 2025

Can confirm userscript works with Tampermonkey on Chrome and Opera - just wait for it to load first.

@mary-ext
Copy link
Author

uBO Lite is very capable, but no you can't set custom filter lists or rules, it's all prebaked.

@cpressland
Copy link

I'm using Policy Based Routes on my UniFi device to route Bluesky, Discord, etc via Mullvad, leaving the rest of my internet traffic intact. The following domains seem to be the main ones to route: bsky.app, cdn.bsky.app, web-cdn.bsky.app

@mary-ext
Copy link
Author

you only need to route bsky.app in particular

@pigsonthewing
Copy link

Excellent, thank you.

Any tips for users of Blokada?

Also, for those of us watching here, please post a note if you have tips for other services, like Reddit.

@mary-ext
Copy link
Author

Blokada doesn't do request transformations, it can only perform blocking/redirection at a domain level

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment