Chrome network error · -302 · HTTP

ERR_UNKNOWN_URL_SCHEME

The URL starts with a scheme Chrome cannot open, such as intent://, whatsapp:// or market://. On Android it is common in WebView apps that do not hand these links to the right app.

Chromium's description

The scheme of the URL is unknown.

Chrome shows it as net::ERR_UNKNOWN_URL_SCHEME, error -302. puppeteer and Playwright report the same name when a page fails to load in Chromium.

Common causes

  • A link to another app (mailto:, tel:, whatsapp:, intent:) opened inside an Android WebView.
  • A typo in the scheme, such as htps://.
  • A custom scheme of an app that is not installed.

How to fix ERR_UNKNOWN_URL_SCHEME

  1. Check the start of the URL for typos.
  2. Install the app the link is meant for.
  3. Android developers: intercept non-http(s) links in shouldOverrideUrlLoading and start them with an Intent.

ERR_UNKNOWN_URL_SCHEME in the screenshot API

The API renders http and https URLs only; any other URL is refused with 422 before the browser starts: The url field must be a valid URL. in errors.url (or Only http and https URLs are allowed. for a well-formed URL with another scheme, such as ftp://). Links to other schemes inside the page do not affect the render.

Only the page's own load can fail a render. An image, script or frame of the page that fails with a network error does not: the page is captured as the browser shows it without that resource.

Check whether a website loads

Rendered in a real browser with cookie banners hidden. Takes 5–30 seconds.

Frequently asked questions

What does ERR_UNKNOWN_URL_SCHEME mean?

The URL starts with a scheme Chrome cannot open, such as intent://, whatsapp:// or market://. On Android it is common in WebView apps that do not hand these links to the right app.

How do I fix ERR_UNKNOWN_URL_SCHEME?

Check the start of the URL for typos.

Is a screenshot that fails with ERR_UNKNOWN_URL_SCHEME billed?

No. Requests the screenshot API answers with an error are not billed.

Other common errors

All 249 Chrome network errors · Screenshot API errors

Screenshot API

Take screenshots from your code

screenshotbase renders any website in a real browser and returns the image: full page or viewport, any device size, retina, from 100+ countries, with cookie banners and ads hidden.

/v1/take documentation Screenshot API All documentation

300 free screenshots every month. No credit card required.

GET https://api.screenshotbase.com/v1/take?url=https://example.com&full_page=true

# Response: the image (PNG, JPG, WebP or GIF)
curl -G "https://api.screenshotbase.com/v1/take" \
  --data-urlencode "url=https://example.com" \
  -d viewport_width=1280 -d viewport_height=800 \
  -d format=png \
  -H "apikey: YOUR-API-KEY" \
  -o screenshot.png

More free tools

Start using our Screenshot API for free today!

Get 300 requests / month for free