How To: Add and Remove Destinations from a Destination Lists

Edit a Destination List

Any destination list can be edited at any time. There are no restrictions on adding or removing destinations from a list.

A Global Allow List, whether Block or Allow, applies to *all* policies and *all* identities, or in other words, it is 'Global' across your organization's configuration. To define a more specific destination list, please a new destination list and add domains only to that list, then apply that list to individual sets of identities through policies.

NOTE: Allow list entries will always take precedence over block list entries. For example:

• Blocking domain.com and adding mail.domain.com to the whitelist will still allow mail.domain.com. 

• Adding domain.com to the Allow List and blocking sub.domain.com will still allow sub.domain.com.

1. In Umbrella, navigate to Policies > Policy List and expand a policy.
   The Policy Summary page opens.
   
   
2. Under Destination Lists Enforced, click Edit.
   You're taken to the Apply Destination Lists step of the policy editor.
3. Click the destination list you want to edit. 
   The page updates to list destinations currently in the list.
   
   
4. Click Edit List.
   The Edit Destinations modal opens.
   
   
5. Add new destinations and when finished click Save.
   You're retuned to the Apply Destination Lists step of the policy editor.
6. Click Set & Return. 

Add a New Destination List

To create custom per-policy filtering, new destinations lists can be created to differentiate policies.

1. In Umbrella, navigate to Policies > Policy List and expand a policy.
   The Policy Summary page opens.
2. Under Destination Lists Enforced, click Edit.
   You're taken to the Apply Destination Lists step of the policy editor.
3. Click Add New List.
   
   
   
   
4. Give your Destination List a good descriptive name, choose Blocked or Allowed, and add destinations:
   
   
5. Click Save.
   You're retuned to the Apply Destination Lists step of the policy editor. By default, your new destination list is added to the policy.
   
   
   
6. Click Set & Return. 

Bulk Adding Domains to a Destination List

You can only bulk upload to existing destination lists. You cannot perform a bulk upload when creating a new destination list.

1. Navigate to Policies > Destination Lists.
   
   IMPORTANT NOTE:  The current uploader supports text files in the format of one domain per line. Be careful with extra space characters, commas, etc. as exceptions to the format of a single FQDN per line can cause errors.
   
   
2. Expand a destination list and click Upload.
   
   
   
   The current uploader supports text files (.txt) in the format of one destination per line. CSV and Excel files are not supported.
   
   
3. Select or drag and drop a .txt file that contains your destinations and click Apply.
   
   
4.  Destinations are added to your destination list in bulk.
   NOTE: If your bulk upload includes unsupported destinations, the upload does not fail, but only supported destinations are successfully added. Unsupported destinations are returned to you in a downloadable spreadsheet that you can use to determine which destinations failed and why.
5. Click Save.

An Important Note about Wildcards

Adding wildcards to your block or allow destination lists is accomplished by an implied, implied wildcard.

Please see the examples below for the syntax of wildcards. Note that the direct use of the asterisk ( * ) is not supported in the Destination lists to apply a wildcard.

Please note that the direct use of the asterisk ( * ) is not supported in the Destination lists to apply a wildcard.  For instance, here are some wildcards that are NOT currently supported: subdomain.*.com, sub*.com, or domain.*

For instance, adding facebook.com is on an Always Block list, any requests to facebook.com or its subdomains, such as images.facebook.com and connect.facebook.com, will be blocked on this network. 

Adding wikipedia.org to a Never Block list will mean any requests to wikipedia.org or its subdomains, such as en.wikipedia.org, will be allowed on this network.

Destination List Editor

Alternately, you can create new destination lists by navigating  to Policies > Destination Lists.  

There, you can create additional destination lists and specify whether or not you want them to be block lists or allow lists. Please note that after you make changes in the Destination List Editor, you will need to ensure that the destination list you've created is definitely linked to one of your policies to take effect.

Add a Destination List to a Policy

1. In Umbrella, navigate to Policies > Policy List and expand a policy.
   The Policy Summary page opens.
2. Under Destination Lists Enforced, click Edit.
   You're taken to the Apply Destination Lists step of the policy editor. All available destination lists are listed. Those not currently used by the policy are not selected.
   
   
3. Select destination lists and click Set and Return.
   
   Please be sure to clear your cache, as shown here: https://support.umbrella.com/hc/en-us/articles/230563747-How-do-I-clear-my-DNS-cache-

If you have any other questions or concerns, please let us know by submitting a support request!

If a Destination List Entry Doesn't Fully Unblock or Allow a Page

Web pages utilize many different domains, and a content domain may be responsible for the remaining blocks. Refer to our best practice for Allowing or blocking a website for more details.