How to Fix Unknown URL Scheme in Android WebView

The unknown url error screen

Fix err_unknown_url_scheme intent://,whatsapp:// etc in Android WebView

Updated on March 4, 2022

This error is appeared in your android webview app because the WebView can’t recognize the special URL Schemes

For example, the WebView will usually recognize http and https, anything other than these, for example – intent://, market://, tel://, mailto:// , whatsapp:// etc will not be recognized by WebView unless we add a handler code to handle these url schemes, or by disabling these schemes and only load http and https schemes.

What are URL schemes in android?

The url schemes like intent://, market://, app://, mailto:// etc are special URL schemes in the webview that can be used to open apps from webview, invoke an android activity or do an action etc. For example, the mailto:// url scheme can be used to send email action directly from the webview.

You can even make your own url scheme and make the webview recognize it so the webview can do your own action that you define

Another example is market://, this can be used to open google playstore action from the webview, another example is whatsapp://, this can be used to directly share a text or link from webview to whatsapp messenger.

If we do not set actions whenever the special url schemes are invoked, it will show the unknown url scheme error. It is possible to stop showing the error screen with a few lines of code, but it is better to fix this error by adding additional code to handle the the url schemes. The additional code can be complex but we can help you.

We have built a webview app template after months of research, the app template now supports most url schemes, i suggest you try the template and you will not need look back and stress to fix the url schemes error, the template is easy to use

Save your time and stress, use our Advanced Webview Template

You can use our Advanced Webview Easy App Template that supports most url schemes and intents to open external apps such as Whatsapp, google playstore, email, tel etc. This template can be imported to android studio and you can change a few things to create a functional webview app and create apks, no more coding because most functions are built in already!

This template also supports the following things:

  • File upload
  • File download
  • Onesignal notifications
  • Drawer menu, bottom navigation bar, option menu
  • GPS access, dark theme and many other features.

This template will save your stress and time. Your full functional webview app for your website now can be easily built and ready in less than an hour using this app template.

All you need is set an app icon, set your website link, change some colors, change app and package name to turn the template to your desired android webview app that supports almost all webview functions. You can download the demo APK to test the uri functions

If you want it, head to this page Download Android Webview Source Code Template.


How to Disable the Url Scheme Error Screen in Android

We can totally disable the error by writing a few lines of code in the onPageFinished and ShouldOverrideUrlLoading

but the problem here is that webview will not handle the schemes, so if you need open the mail app, the mail:// will not work, only https and http links will be handled by webview

Here is how to disable other url schemes and allow only http and https

import android.os.Bundle;
import android.webkit.WebView;
import android.webkit.WebViewClient;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {

    String url = "";
    protected void onCreate(Bundle savedInstanceState) {

        final WebView webview = (WebView) findViewById(;

        webview.setWebViewClient(new WebViewClient(){

        public boolean shouldOverrideUrlLoading(WebView view, String url) {

            if (url.startsWith("http") || url.startsWith("https")) {
                return true;
            }else {
                Toast.makeText(MainActivity.this, "Unknown Link, unable to handle", Toast.LENGTH_SHORT).show();
            return false;



How to set actions for these special url schemes

You can set actions to any of the url schemes with the onPageFinished  method in the webview

Here is an example

The code here is executed if the clicked url in the webview starts with whatsapp://,  if whatsapp is already installed, then the webview will attempt to share the current page link to whatsapp, if whatsapp is not installed, it will show a toast message

public boolean shouldOverrideUrlLoading(WebView view, String url) {

                if (url.startsWith("whatsapp://")) {
                    try {
                        Intent whatsappIntent = new Intent(Intent.ACTION_SEND);

                        whatsappIntent.putExtra(Intent.EXTRA_TEXT, webview.getUrl() + "  - Shared from webview ");

                    } catch (android.content.ActivityNotFoundException ex) {

                        String MakeShortText = "Whatsapp have not been installed";

                        Toast.makeText(WebactivityTab1.this, MakeShortText, Toast.LENGTH_SHORT).show();



Another examples

Here is an example to fix the common intent url scheme , we will learn how to handle the intent:// here , i noticed this error when i built an app that loads facebook messages, the error appeared whenever i tap on the message icon of facebook. i suppose this is because the facebook is sending you to app store to download the messenger app when you tap on the message icon. In the below code, we will fix it.

The Code to Fix err_unknown_url_scheme intent://


webview.setWebViewClient(new WebViewClient() {
           String currentUrl;

           public boolean shouldOverrideUrlLoading(WebView view, String url) {
               currentUrl = url;

               if (url.startsWith("http") || url.startsWith("https")) {
                   return false;
               if (url.startsWith("intent")) {

                 try {
                     Intent intent = Intent.parseUri(url, Intent.URI_INTENT_SCHEME);

                     String fallbackUrl = intent.getStringExtra("browser_fallback_url");
                   if (fallbackUrl != null) {
                       return true;

               catch (URISyntaxException e) {
                   //not an intent uri
       return true;//do nothing in other cases


What we did in this code is whenever the url we clicked contain intent:// scheme, we try to override it and get the fallbackUrl to the string, then we try to load the url. this should fix the intent error

You can set your own scheme handler for your apps from these examples

Update: If you are new to android development, or just want fix this url scheme error code, i can fix it for you for a small fee of US $5. Just send me your project  (export to zip) or that java or kotlin file (The MainActivity or the Activity where you wish to fix url scheme) through email or google drive, i will fix your project or file and send it back to you. I can also do it through TeamViewer or AnyDesk

You can pay through Paypal , GooglePay, PayTM, PhonePe or any payment method your country supports. For more details, contact me through:

If you want convert your website to android app in just 2 hours, we can do it, see this page Online Android App Builder
If you want a very advanced webview source code see this page Download Android Webview App Source Code Template

Related Posts

Add Admob ads in recyclerview in android

How to add admob native ads to recyclerview in android java Adding admob native ads into android recyclerview isn’t easy like other admob ads. You will need…

Download WebView Flutter Source Code for Android and iOS

Easily create android and iOS WebView app for your websites, the much-awaited flutter WebView source code is here. Are you looking for a flutter WebView source code…

Fix uses-sdk:minSdkVersion 16 cannot be smaller than version 19 declared in library [:_flutter_android]

This error can be fixed by modifying build.gradle file in the flutter In android studio: go to android>app>build.gradle and modify it as follows:

Get Your Own Android Mobile App for Your Website Today

Are you looking to expand your online presence and reach more customers? In today’s digital age, having a mobile app is an essential tool to connect with…

Why making an app for your website can help your business to grow

In today’s digital age, it’s more important than ever to have a strong online presence. Whether you’re running a business, a blog, or a personal website, having…

Fix android.content.Intent.migrateExtraStreamToClipData(android.content.Context)’ on a null object reference

Here is how to Fix Android Studio Error Attempt to invoke virtual method ‘boolean android.content.Intent.migrateExtraStreamToClipData(android.content.Context)’ on a null object reference This error is caused by a number…

This Post Has 23 Comments

          1. where to add this code ?? I added in MainActivity but it is nor working.. and can i publish webview app in playstore? my website shows adsense ads, and i read somewhere adsense in webview app in not allow in playstore it is against admob policy ???

          2. You can add in main activity, yes, according to google’s rule, you are not allowed to show webview of a website you don’t own or don’t have permission. if you own the website, it is ok, but do not place admob ads in your app if your website has adsense. adsense+admob= ban or app disable

  1. Hi there, How about paytm app? I manage to pull the paytm app, However, once you login into paytm app, The app doesn’t redirect to paytm app anymore

  2. i am getting an error in 1st code at @Override it say “method does not override or implement a method from a supertype”

      1. Yes you were right i did it successfully. Thank you
        Can you help me with playstore, like when i click on a link in webview it should redirect me to the playstore to particular app of link

Leave a Reply

Your email address will not be published. Required fields are marked *