This article tells you how to set up scan exclusions.
The Scan exclusion function in Acquia Web Governance lets Admin users configure custom exclusions to website scans. The configuration helps to target particular elements and prevent the contents from being flagged as issues.
Add exclusions to accessibility, readability, and misspelling checks on a customer level and then apply them to specific domains.
Scan exclusions use Regular Expressions (regexes). Regexes are application programming interfaces (APIs) that define string patterns. You can use a regex to search, manipulate, and edit a string in Java. For example, a regex can define the constraints for email validation and passwords.
Note
Regexes in path constraints are not fully compatible with the
Policies
module. The languages are different (Java and Ruby). For more information and examples, read .
How to create a scan exclusion
Introduction
This article tells you how to set up scan exclusions.
The Scan exclusion function in Acquia Web Governance lets Admin users configure custom exclusions to website scans. The configuration helps to target particular elements and prevent the contents from being flagged as issues.
Add exclusions to accessibility, readability, and misspelling checks on a customer level and then apply them to specific domains.
Scan exclusions use Regular Expressions (regexes). Regexes are application programming interfaces (APIs) that define string patterns. You can use a regex to search, manipulate, and edit a string in Java. For example, a regex can define the constraints for email validation and passwords.
Note
Regexes in path constraints are not fully compatible with the
Policies
module. The languages are different (Java and Ruby). For more information and examples, read Class Patterns by Oracle.
Video walkthrough on scan exclusion setup
This video provides a walkthrough of the steps outlined in this document.
Navigation
Follow these steps to view current scan exclusions:
Log in to Web Governance.
Select the applicable domain.
Click Admin on the top menu bar.
Click Scan Exclusions on the left menu.
Scan Exclusions landing page
This section describes the Scan Exclusions dashboard. The page contains these elements:
Tabs:
Accessibility
, Misspellings, Language Validation, and Readability.
Add scan exclusion button.
Create a scan exclusion
You can create four types of scan exclusions:
Accessibility
Misspellings
Language Validation
Readability
The sections below give the steps for each type of scan exclusion.
Create an Accessibility scan exclusion
Log in to Web Governance.
Select the applicable domain.
Click Admin on the top menu bar.
Click Add a scan exclusion.
In the Details section, provide the requested information:
Type: Select Accessibility.
Title: Provide a title for the exclusion.
Auto-apply to domains with CMS: Click the arrow and select a CMS.
Apply exclusion to domains: Click the arrow and type in a search phrase to find domains.
In the HTML exclusion section, provide the requested information to exclude an element based on name in the webpage source code:
Type: Click the arrow and select the type of HTML that best matches the scope of the exclusion:
Exact
Regex
Contains
Value: Enter or paste the source code snippet that you want to exclude. Find this in the source code for the page.
Checks: Click the arrow and select the accessibility checks that you want to exclude from the scan.
To add a new exclusion, click +Add exclusion.
Create a Misspellings scan exclusion
Log in to Web Governance.
Select the applicable domain.
Click Admin on the top menu bar.
Click Add a scan exclusion.
In the Details section, provide the requested information:
Type: Select Misspellings.
Title: Provide a title for the exclusion.
Auto-apply to domains with CMS: Click the arrow and select a CMS.
Apply exclusion to domains: Click the arrow and type in a search phrase to find domains.
In the CSS selector exclusion section, provide the requested information to exclude an element based on its CSS selector tagname, class, ID, or attribute.
To add a new exclusion, click +Add exclusion.
Create a Language Validation scan exclusion
Log in to Web Governance.
Select the applicable domain.
Click Admin on the top menu bar.
Click Add a scan exclusion.
In the Details section, provide the requested information:
Type: Select Language Validation.
Title: Provide a title for the exclusion.
Auto-apply to domains with CMS: Click the arrow and select a CMS.
Apply exclusion to domains: Click the arrow and type in a search phrase to find domains.
In the CSS selector exclusion section, provide the requested information to exclude an element based on its CSS selector tagname, class, ID, or attribute.
To add a new exclusion, click +Add exclusion.
Create a Readability scan exclusion
Log in to Web Governance
Select the applicable domain.
Click Admin on the top menu bar.
Click Add a scan exclusion.
In the Details section, provide the requested information:
Type: Select Readability.
Title: Provide a title for the exclusion.
Auto-apply to domains with CMS: Click the arrow and select a CMS.
Apply exclusion to domains: Click the arrow and type in a search phrase to find domains.
In the CSS selector exclusion section, provide the requested information to exclude an element based on its CSS selector tagname, class, ID, or attribute.
To add a new exclusion, click +Add exclusion.
Edit a scan exclusion
Log in to Web Governance.
Select the applicable domain.
Click Admin on the top menu bar.
Click Scan Exclusions on the left menu.
Find the scan exclusion that you want to edit.
Click the Action icon (three vertical dots) on that row.
Click Edit.
Change the data as necessary.
Click Save at the bottom of the page.
Delete a scan exclusion
Log in to Web Governance.
Select the applicable domain.
Click Admin on the top menu bar.
Click Scan Exclusions on the left menu.
Find the scan exclusion that you want to delete.
Click the Action icon (three vertical dots) on that row.
Click Delete.
Click Delete in the confirmation dialog.
Click Save at the bottom of the page.
Click Admin Settings (the gear icon) on the top menu bar.
The system displays the Admin dashboard.
Click Add a Scan Exclusion in the Quick actions section.
Alternatively:
Click Configuration (the wrench icon) on the left menu bar.
Select Scan Exclusion from the expanded options.
Select the type of scan exclusion that you want to add:
Accessibility
Misspellings
Readability
Accessibility scan exclusions
This section provides instructions on the fields that you need to complete to create an accessibility scan exclusion.
Title (required): Add a title that describes the exclusion.
Auto-apply to domains with CMS: Do one of the following:
Select None (default) if there is no CMS.
Scroll through the list and select the CMS that is used for your domain.
Notes
If a domain with the same selected CMS exists on the Web Governance account, the domain automatically inherits the exclusion.
If the CMS used for your domain is not present in the list, contact the Support team and ask them to investigate if it is possible to add it.
HTML Exclusion: Provide the following information to exclude elements based on their name in the web page source code:
Type (required). Select from the available options:
Misspelled words scan exclusions
This section provides instructions on how to exclude a segment of a webpage from the spellcheck.
Title: Add a title that describes the exclusion (required).
Auto-apply to domains with CMS: Select the CMS that is used for your domain. Select None (default) if there is no CMS.
Note
If a domain with the same selected CMS exists on the Web Governance account, the domain automatically inherits the exclusion.
If the CMS used for your domain is not present in the list, contact the Support team and ask them to investigate if it is possible to add it.
Apply exclusion to domains: Begin to type the name of the domain to populate the list and select one or more domains to apply this exclusion on.
CSS Selector Exclusion (required): Click in the field and select an existing CSS selector pattern from the drop-down menu, or click + to add a new one. Add as many as you need. Subsequent scans identify elements that match the entered CSS selector patterns and they are omitted from the results.
Click Save.
Add the updated script to the HTML code. For more information, visit How to add the script.
This section provides instructions on how to exclude a webpage from the Readability feature.
Title (required): Add a title that describes the exclusion.
Auto-apply to domains with CMS: Select the CMS that is used for your domain. Select None (default) if there is no CMS.
Apply exclusion to domains: Begin typing the name of the domain and select one or more domains to apply this exclusion on.
CSS Selector Exclusion (required): Click in the field and select an existing CSS selector pattern from the drop-down menu, or click + to add a new one. Add as many as you need. Subsequent scans identify elements that match the entered CSS selector patterns and they are omitted from the results.
Click Save.
Add the updated script to the HTML code. For more information, visit How to add the script.
Editing a scan exclusion
This section provides instructions on how to edit an existing scan exclusion.
Click Admin Settings (the gear icon) on the top menu bar.
The system displays the Admin dashboard.
Click Configuration (the wrench icon) on the left menu bar.
Select Scan Exclusion from the expanded options.
The system displays the list of existing scan exclusions.
On the same row as the scan exclusion that you want to edit, click the kebab menu and select Edit.
Make the changes as needed.
Save the changes.
Deleting a scan exclusion
This section provides instructions on how to delete a scan exclusion.
Click Admin Settings (the gear icon) on the top menu bar.
The system displays the Admin dashboard.
Click Configuration (the wrench icon) on the left menu bar.
Select Scan Exclusion from the expanded options.
The system displays the list of existing scan exclusions.
Click the kebab menu on the same row as the scan exclusion that you want to delete and select Delete.
The system displays a confirmation dialog box.
Click Delete in the dialog box to confirm. The system removes the scan exclusion from the list and from any domain that it was used on.
This video provides a walkthrough of the steps outlined in this document.
Navigation
Follow these steps to view current scan exclusions:
Log in to Web Governance.
Select the applicable domain.
Click Admin on the top menu bar.
Click Scan Exclusions on the left menu.
Scan Exclusions landing page
This section describes the Scan Exclusions dashboard. The page contains these elements:
Tabs:
Accessibility
, Misspellings, Language Validation, and Readability.
Add scan exclusion button.
Data table: The table contains these columns:
Title: Shows the name of the scan exclusion.
Actions: Opens a menu with Edit and Delete options.
Create a scan exclusion
You can create four types of scan exclusions:
Accessibility
Misspellings
Language Validation
Readability
The sections below give the steps for each type of scan exclusion.
Create an Accessibility scan exclusion
Log in to Web Governance.
Select the applicable domain.
Click Admin on the top menu bar.
Click Add a scan exclusion.
In the Details section, provide the requested information:
Type: Select Accessibility.
Title: Provide a title for the exclusion.
Auto-apply to domains with CMS: Click the arrow and select a CMS.
Apply exclusion to domains: Click the arrow and type in a search phrase to find domains.
In the HTML exclusion section, provide the requested information to exclude an element based on name in the webpage source code:
Type: Click the arrow and select the type of HTML that best matches the scope of the exclusion:
Exact
Regex
Contains
Value: Enter or paste the source code snippet that you want to exclude. Find this in the source code for the page.
Checks: Click the arrow and select the accessibility checks that you want to exclude from the scan.
To add a new exclusion, click +Add exclusion.
Create a Misspellings scan exclusion
Log in to Web Governance.
Select the applicable domain.
Click Admin on the top menu bar.
Click Add a scan exclusion.
In the Details section, provide the requested information:
Type: Select Misspellings.
Title: Provide a title for the exclusion.
Auto-apply to domains with CMS: Click the arrow and select a CMS.
Apply exclusion to domains: Click the arrow and type in a search phrase to find domains.
In the CSS selector exclusion section, provide the requested information to exclude an element based on its CSS selector tagname, class, ID, or attribute.
To add a new exclusion, click +Add exclusion.
Create a Language Validation scan exclusion
Log in to Web Governance.
Select the applicable domain.
Click Admin on the top menu bar.
Click Add a scan exclusion.
In the Details section, provide the requested information:
Type: Select Language Validation.
Title: Provide a title for the exclusion.
Auto-apply to domains with CMS: Click the arrow and select a CMS.
Apply exclusion to domains: Click the arrow and type in a search phrase to find domains.
In the CSS selector exclusion section, provide the requested information to exclude an element based on its CSS selector tagname, class, ID, or attribute.
To add a new exclusion, click +Add exclusion.
Create a Readability scan exclusion
Log in to Web Governance
Select the applicable domain.
Click Admin on the top menu bar.
Click Add a scan exclusion.
In the Details section, provide the requested information:
Type: Select Readability.
Title: Provide a title for the exclusion.
Auto-apply to domains with CMS: Click the arrow and select a CMS.
Apply exclusion to domains: Click the arrow and type in a search phrase to find domains.
In the CSS selector exclusion section, provide the requested information to exclude an element based on its CSS selector tagname, class, ID, or attribute.
To add a new exclusion, click +Add exclusion.
Edit a scan exclusion
Log in to Web Governance.
Select the applicable domain.
Click Admin on the top menu bar.
Click Scan Exclusions on the left menu.
Find the scan exclusion that you want to edit.
Click the Action icon (three vertical dots) on that row.
Click Edit.
Change the data as necessary.
Click Save at the bottom of the page.
Delete a scan exclusion
Log in to Web Governance.
Select the applicable domain.
Click Admin on the top menu bar.
Click Scan Exclusions on the left menu.
Find the scan exclusion that you want to delete.
Click the Action icon (three vertical dots) on that row.
Click Delete.
Click Delete in the confirmation dialog.
Click Save at the bottom of the page.
Click Admin Settings (the gear icon) on the top menu bar.
The system displays the Admin dashboard.
Click Add a Scan Exclusion in the Quick actions section.
Alternatively:
Click Configuration (the wrench icon) on the left menu bar.
Select Scan Exclusion from the expanded options.
Select the type of scan exclusion that you want to add:
Accessibility
Misspellings
Readability
Accessibility scan exclusions
This section provides instructions on the fields that you need to complete to create an accessibility scan exclusion.
Title (required): Add a title that describes the exclusion.
Auto-apply to domains with CMS: Do one of the following:
Select None (default) if there is no CMS.
Scroll through the list and select the CMS that is used for your domain.
Notes
If a domain with the same selected CMS exists on the Web Governance account, the domain automatically inherits the exclusion.
If the CMS used for your domain is not present in the list, contact the Support team and ask them to investigate if it is possible to add it.
HTML Exclusion: Provide the following information to exclude elements based on their name in the web page source code:
Type (required). Select from the available options:
Exact: This type identifies and filters out all instances where the complete and exact HTML snippet is displayed. For example, the snippet https://www. example.com/ is an exact match for https://www.example.com/.
The following HTML snippets are not exact matches:
https://www.example.com
http://www.example.com/
https://example.com/
https://example.com/?something=1
https://example.com/#something=1
Regex: This type identifies and filters out specific patterns of HTML through the use of regular expressions.
Contains: This type identifies and filters out all snippets that contain the HTML values entered. For example, the snippet example.com is a match for the following HTML snippets:
https://www.example.com/
https://www.example.com
http://www. example.com/
https://example.com/
https://example.com/?query=1
https://example.com/subpage
https://example.com/subpage/product_page
Value (required). Enter or paste the source code snippet that you want to exclude.
For example: <h2 class: “form-title”>
Checks
Begin typing the name of the check and select the Accessibility checks to exclude from the list. Select as many as needed.
Click Save.
Repeat as needed.
Add the updated script to the HTML code. For more information, visit How to add the script.
Misspelled words scan exclusions
This section provides instructions on how to exclude a segment of a webpage from the spellcheck.
Title: Add a title that describes the exclusion (required).
Auto-apply to domains with CMS: Select the CMS that is used for your domain. Select None (default) if there is no CMS.
Note
If a domain with the same selected CMS exists on the Web Governance account, the domain automatically inherits the exclusion.
If the CMS used for your domain is not present in the list, contact the Support team and ask them to investigate if it is possible to add it.
Apply exclusion to domains: Begin to type the name of the domain to populate the list and select one or more domains to apply this exclusion on.
CSS Selector Exclusion (required): Click in the field and select an existing CSS selector pattern from the drop-down menu, or click + to add a new one. Add as many as you need. Subsequent scans identify elements that match the entered CSS selector patterns and they are omitted from the results.
Click Save.
Add the updated script to the HTML code. For more information, visit How to add the script.
Fix Misspelled words for instructions on how to repair misspelled words with other Web Governance modules.
Readability scan exclusions
This section provides instructions on how to exclude a webpage from the Readability feature.
Title (required): Add a title that describes the exclusion.
Auto-apply to domains with CMS: Select the CMS that is used for your domain. Select None (default) if there is no CMS.
Apply exclusion to domains: Begin typing the name of the domain and select one or more domains to apply this exclusion on.
CSS Selector Exclusion (required): Click in the field and select an existing CSS selector pattern from the drop-down menu, or click + to add a new one. Add as many as you need. Subsequent scans identify elements that match the entered CSS selector patterns and they are omitted from the results.
Click Save.
Add the updated script to the HTML code. For more information, visit How to add the script.
Editing a scan exclusion
This section provides instructions on how to edit an existing scan exclusion.
Click Admin Settings (the gear icon) on the top menu bar.
The system displays the Admin dashboard.
Click Configuration (the wrench icon) on the left menu bar.
Select Scan Exclusion from the expanded options.
The system displays the list of existing scan exclusions.
On the same row as the scan exclusion that you want to edit, click the kebab menu and select Edit.
Make the changes as needed.
Save the changes.
Deleting a scan exclusion
This section provides instructions on how to delete a scan exclusion.
Click Admin Settings (the gear icon) on the top menu bar.
The system displays the Admin dashboard.
Click Configuration (the wrench icon) on the left menu bar.
Select Scan Exclusion from the expanded options.
The system displays the list of existing scan exclusions.
Click the kebab menu on the same row as the scan exclusion that you want to delete and select Delete.
The system displays a confirmation dialog box.
Click Delete in the dialog box to confirm. The system removes the scan exclusion from the list and from any domain that it was used on.
If this content did not answer your questions, try searching or contacting our support team for further assistance.
Data table: The table contains these columns:
Title: Shows the name of the scan exclusion.
Actions: Opens a menu with Edit and Delete options.
Exact: This type identifies and filters out all instances where the complete and exact HTML snippet is displayed. For example, the snippet https://www. example.com/ is an exact match for https://www.example.com/.
The following HTML snippets are not exact matches:
https://www.example.com
http://www.example.com/
https://example.com/
https://example.com/?something=1
https://example.com/#something=1
Regex: This type identifies and filters out specific patterns of HTML through the use of regular expressions.
Contains: This type identifies and filters out all snippets that contain the HTML values entered. For example, the snippet example.com is a match for the following HTML snippets:
https://www.example.com/
https://www.example.com
http://www. example.com/
https://example.com/
https://example.com/?query=1
https://example.com/subpage
https://example.com/subpage/product_page
Value (required). Enter or paste the source code snippet that you want to exclude.
For example: <h2 class: “form-title”>
Checks
Begin typing the name of the check and select the Accessibility checks to exclude from the list. Select as many as needed.
Click Save.
Repeat as needed.
Add the updated script to the HTML code. For more information, visit How to add the script.
Fix Misspelled words for instructions on how to repair misspelled words with other Web Governance modules.
Did not find what you were looking for?
If this content did not answer your questions, try searching or contacting our support team for further assistance.
Web Governance