Block Pages

Article author
Josh Lamb
  • Updated

A block page is what your users see when they attempt to visit a domain that is not allowed by the policy you have assigned to their network or Roaming Client. DNSFilter allows you to customize the appearance, behavior, bypass passwords, and notifications related to a block page.

There are two types of block pages:

  • A hosted block page will halt the user and present organizational information, as well as options to enter a bypass password or notify the administrator.
  • An external block page will immediately send a 302 redirect to the user to a location that you set. This may be a local-only resource (http://office.local/block.html) or a public resource (

Below is a video demonstration of creating a block page:

Block Page Appearance

DNSFilter allows for you to customize the block page in a variety of ways. Only hosted block pages can be customized, for the reason that an external block page is actually a redirect to a custom web location.

A hosted block page can be created by navigating to the Policies > “Block Pages” category on the dashboard and selecting “Hosted Block Page” as shown below.


Several fields are available to edit:

  1. Block Page Name - The internal friendly name that is used by you to assign the policy to your networks.
  2. Organization Name - The is the name of your organization that will be displayed as the party responsible for blocking access to the domain.
  3. Notice E-mail - This is the e-mail address which will receive complaints/requests from endusers for unblocking or reviewing the domain in question via an embedded form. (Leaving this field blank disables the ability to send a message).
  4. Custom Logo - This allows you to display a logo no the block pages. (Leave blank to show no logo).


Testing Block Page

You can test your custom block page by either using our test domains located at the following link - Test Domains or by attempting to browse to either a blocked category or domain you have added to your block list. 

Block Page FAQs

  • Yes. Hosted Block Pages can display in one of several languages, depending on the browser language of the enduser device. The languages we currently support are: English, Spanish, Portuguese, Turkish, Ukrainian, Italian, Russian, French, Czech, German, and Hebrew.

  • Yes. We support a 302 redirect to another webpage for a completely custom appearance.

Block Page Bypass

Bypass Passwords are a legacy feature which will be replaced due to the following shortcomings:
  • Once a Bypass Password is used, it bypasses all blocked categories, domains, and security categories for the duration of the browser session. There is no granularity with regards to what is or isn’t allowed, or how long it’s allowed.
  • Some websites do not work with Bypass Passwords, such as:
    • YouTube
    • Facebook
    • ESPN
We recommended utilizing our Roaming Clients for granular content filtering when


This feature allows an administrator to specify a password that can be used to bypass Filtering Policies when users encounter a blocked website. The password is used on a per-policy basis, not on a per-website basis, so keep this in mind when developing your policies. It is also not time-limited, so the password will always be valid for that policy unless it is changed.

To set a proxy bypass password, first edit/create a Block Page in the Policies Menu. Ensure that you have the “Hosted Block Page” selected as the block page type:

You may then navigate to the Bypass Password tab, turn on the feature, and enter a password:


To make sure this feature works with websites over HTTPS, please consider installing our SSL Certificate.

Assigning a Block Page

Once you have customized your block page type and appearance, you are ready to assign it to the appropriate site(s). To do this, navigate to the Deployments > "Sites" section of the dashboard. Click the row matching your desired site under the "Assigned Block Page" column. A dropdown will appear for you to select the name of your block page. A confirmation dialog will appear that your network has been updated.


Responding to a Block Page Notification

If you have entered a Notice E-mail on a hosted block page, you will receive email notifications from users when they request that you take action to unblock a page. There are a few steps to take upon receiving these emails:

  1. Compare the user’s requested site against your filtering policy. Visit the site to see if the content is in violation of the policy.
  2. You can choose to whitelist the site if it seems as though the categorization is correct, but for business reasons, you still need to allow access for your network.
  3. If it appears as though the categorization is incorrect, you can use the Domain Lookup tool in the upper-right of our app, and submit a miscategorization request. We typically process these within 1-2 days. You can choose to whitelist the domain prior to our recategorization so that your users have immediate access.

Was this article helpful?

3 out of 6 found this helpful

Have more questions? Submit a request



Article is closed for comments.