Acquia Copilot is a conversational AI connected into our product documentation and knowledge base. Ask Copilot about product features, technical details, troubleshooting and how to get started with Acquia products.
How to do a PDF accessibility scan and request a PDF remediation with Acquia Web Governance. PDF scans are done through a Remediation Quote. Order a list of issues that require attention in the PDF. This service is provided by a third-party provider, CommonLook Clarity:
EU customers must contact Commonlook directly for PDF remediation quotes at their own discretion due to regulatory requirements. The PDF Remediation option continues to be available for customers in other geographical regions.
The Content Links count in the Inventory module shows the number of links that point to PDF files. This is not the same as PDF files that are internal and present on the site. For example, the inventory may state a higher number of PDF links than the Accessibility module PDF file count.
Include PDF files in the scan
This section provides instructions on how to do a PDF accessibility scan.
Navigate to your domain dashboard.
On the top menu bar, click Accessibility (icon of a human figure with outstretched arms).
The Accessibility summary page opens.
Click PDFs from the menu on the left side of the page.
The list expands with more choices:
Internal PDFs: Select this option if the PDF file is uploaded on your site.
Sort the chart with the following options:
Pending
Reviewed/OK
Queued
Failed.
External PDFs:Select this option if the PDF file is not on your site.
The External PDFs page opens. The list shows all external PDF files that you need to check for accessibility issues. The chart gives a graphic view of:
PDF files reviewed
PDF files pending.
Action: Click to expand the list of options.
Select Start PDF Accessibility scan: Select to scan this PDF.
The PDF file moves into the Queued column.
If the PDF is located externally, select External PDFs: The External PDFs page opens. The chart has the following sorting options:
Pending
Reviewed/OK.
Click a PDF in the list to view the URL and scan information.
The scan results are imported directly into your account and are available through the dashboard.
If the scan is successful and no accessibility errors are found, the PDF is automatically moved to the Reviewed/OK column. Select the PDF to view the results.
If the scan is successful and some accessibility errors are found, the PDF is automatically moved to the Failed column. Click to view the scan results and the issues detected. Repair the errors or use the PDF remediation option as described below in the Remediation Quote instructions, upload the new PDF documents, and then start a new scan.
Here is an example of how the scan report can look:
Columns are:
Name: The name of the error. In this example, the first row is "Alternative Representat.." (truncated).
Result_type: The type of error. In this example, the first row is "error".
Page_number: The page that the error is on. In this example, the first row is "1".
Element_tree_path: How to locate this error directly in the tree path for the report. In this example, the first row is "Annotations->11".
Reason: The reason for the error. In this example, the first row is "Link Annotation doesn't..." (truncated).
Clarity_comments: Any comments from the CommonLook/Clarity team. In this example, the first row is empty.
Check the scan results
To find more details about the PDF from the scan results, the Quality Assurance feature can provide some additional details.
Instructions
Navigate to your domain.
Click Quality Assurance (the checkbox icon), on the domain dashboard toolbar.
The Quality Assurance page opens.
Click Content with QA Errors from the menu on the left side of the page.
The Content with QA Errors page opens.
On the menu bar at the top of the chart, click to navigate to PDF Documents.
Click a document in the list to view more information about the scan results.
If the scan is successful and no accessibility errors are found, it is automatically moved to the Reviewed/Ok column. Select the PDF to view the results.
If the scan is successful and some accessibility errors are found, the PDF is automatically moved to the Failed column. Click to view the scan results and the issues detected. Repair the errors or use the PDF remediation option as described below in the Remediation Quote instructions, upload the new PDF documents, and then start a new scan.
Remediation quote
If any PDF files require remediation, this can be requested from within the platform. The remediated documents and accessibility reports are delivered to your email when they are ready. To include the PDF scanning tool, contact Support to upgrade your account.
Do an accessibility scan as per the previous section and locate the non-compliant PDF files.
Click to select Remediation Quote on the same row as a non-compliant PDF
This submits anorder for remediation of issues that require attention in the PDF. This service is provided by a third party. A dialog box opens with the following text:
"Document remediation for compliance to WCAG 2.1 AA, Section 508, HHS or PDF/UA accessibility standards. Document remediation requires manual verification and can range in cost. When you submit PDF documents for remediation, we will review the document and give you a firm, fixed price for the remediation. Upon completion of the work, we will also provide a compliance report. We will let you know if there is any Alternative Text (Alt-Text) required for images that are not self-descriptive or any related additional information needed to remediate the document."
Click OK to confirm.
The remediated PDFs are sent to your email when they are finished.
Remove the old PDFs from the website and upload the remediated PDFs.
Change the status of the PDFs manually to Mark as reviewed. This moves the files to the Reviewed/OK folder in the user interface.
Note
EU customers must contact Commonlook directly for PDF remediation quotes at their own discretion due to regulatory requirements. The PDF Remediation option continues to be available for customers in other geographical regions.
For more information on the PDF accessibility scan service, see:
Bulk remediation quotes and PDF accessibility checks
For accounts that are upgraded to include the PDF scanning tool, it is possible to do a bulk remediation quote to include all PDFs.
Click Accessibility from the domain dashboard.
Click PDFs from the menu on the left.
Click Internal PDFs from the expanded selection.
Choose one of the following bulk options:
Mark all as reviewed: Select this option to mark all PDF files as reviewed.
Request PDF accessibility check for all: Select this option to request a PDF accessibility check for all PDF files.
Request remediation quote for all: Select this option to request a remediation quote for all PDF files.
Contact Support for more information. PDF tracking allows users to see which files are remediated.
Note
EU customers must contact Commonlook directly for PDF remediation quotes at their own discretion due to regulatory requirements. The PDF Remediation option continues to be available for customers in other geographical regions.
Advanced instructions
Some web security measures block the CommonLook PDF crawler that Web Governance uses. If you encounter issues with the PDF scan, allow-list these additional IP addresses and user agents.
PDF scan IP addresses
20.246.128.115
20.113.18.110
PDF scan user agents
Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36
Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko)
How to do a PDF accessibility scan and request a PDF remediation with Acquia Web Governance. PDF scans are done through a Remediation Quote. Order a list of issues that require attention in the PDF. This service is provided by a third-party provider, CommonLook Clarity:
EU customers must contact Commonlook directly for PDF remediation quotes at their own discretion due to regulatory requirements. The PDF Remediation option continues to be available for customers in other geographical regions.
The Content Links count in the Inventory module shows the number of links that point to PDF files. This is not the same as PDF files that are internal and present on the site. For example, the inventory may state a higher number of PDF links than the Accessibility module PDF file count.
Include PDF files in the scan
This section provides instructions on how to do a PDF accessibility scan.
Navigate to your domain dashboard.
On the top menu bar, click Accessibility (icon of a human figure with outstretched arms).
The Accessibility summary page opens.
Click PDFs from the menu on the left side of the page.
The list expands with more choices:
Internal PDFs: Select this option if the PDF file is uploaded on your site.
Sort the chart with the following options:
Pending
Reviewed/OK
Queued
Failed.
External PDFs:Select this option if the PDF file is not on your site.
The External PDFs page opens. The list shows all external PDF files that you need to check for accessibility issues. The chart gives a graphic view of:
PDF files reviewed
PDF files pending.
Action: Click to expand the list of options.
Select Start PDF Accessibility scan: Select to scan this PDF.
The PDF file moves into the Queued column.
If the PDF is located externally, select External PDFs: The External PDFs page opens. The chart has the following sorting options:
Pending
Reviewed/OK.
Click a PDF in the list to view the URL and scan information.
The scan results are imported directly into your account and are available through the dashboard.
If the scan is successful and no accessibility errors are found, the PDF is automatically moved to the Reviewed/OK column. Select the PDF to view the results.
If the scan is successful and some accessibility errors are found, the PDF is automatically moved to the Failed column. Click to view the scan results and the issues detected. Repair the errors or use the PDF remediation option as described below in the Remediation Quote instructions, upload the new PDF documents, and then start a new scan.
Here is an example of how the scan report can look:
Columns are:
Name: The name of the error. In this example, the first row is "Alternative Representat.." (truncated).
Result_type: The type of error. In this example, the first row is "error".
Page_number: The page that the error is on. In this example, the first row is "1".
Element_tree_path: How to locate this error directly in the tree path for the report. In this example, the first row is "Annotations->11".
Reason: The reason for the error. In this example, the first row is "Link Annotation doesn't..." (truncated).
Clarity_comments: Any comments from the CommonLook/Clarity team. In this example, the first row is empty.
Check the scan results
To find more details about the PDF from the scan results, the Quality Assurance feature can provide some additional details.
Instructions
Navigate to your domain.
Click Quality Assurance (the checkbox icon), on the domain dashboard toolbar.
The Quality Assurance page opens.
Click Content with QA Errors from the menu on the left side of the page.
The Content with QA Errors page opens.
On the menu bar at the top of the chart, click to navigate to PDF Documents.
Click a document in the list to view more information about the scan results.
If the scan is successful and no accessibility errors are found, it is automatically moved to the Reviewed/Ok column. Select the PDF to view the results.
If the scan is successful and some accessibility errors are found, the PDF is automatically moved to the Failed column. Click to view the scan results and the issues detected. Repair the errors or use the PDF remediation option as described below in the Remediation Quote instructions, upload the new PDF documents, and then start a new scan.
Remediation quote
If any PDF files require remediation, this can be requested from within the platform. The remediated documents and accessibility reports are delivered to your email when they are ready. To include the PDF scanning tool, contact Support to upgrade your account.
Do an accessibility scan as per the previous section and locate the non-compliant PDF files.
Click to select Remediation Quote on the same row as a non-compliant PDF
This submits anorder for remediation of issues that require attention in the PDF. This service is provided by a third party. A dialog box opens with the following text:
"Document remediation for compliance to WCAG 2.1 AA, Section 508, HHS or PDF/UA accessibility standards. Document remediation requires manual verification and can range in cost. When you submit PDF documents for remediation, we will review the document and give you a firm, fixed price for the remediation. Upon completion of the work, we will also provide a compliance report. We will let you know if there is any Alternative Text (Alt-Text) required for images that are not self-descriptive or any related additional information needed to remediate the document."
Click OK to confirm.
The remediated PDFs are sent to your email when they are finished.
Remove the old PDFs from the website and upload the remediated PDFs.
Change the status of the PDFs manually to Mark as reviewed. This moves the files to the Reviewed/OK folder in the user interface.
Note
EU customers must contact Commonlook directly for PDF remediation quotes at their own discretion due to regulatory requirements. The PDF Remediation option continues to be available for customers in other geographical regions.
For more information on the PDF accessibility scan service, see:
Bulk remediation quotes and PDF accessibility checks
For accounts that are upgraded to include the PDF scanning tool, it is possible to do a bulk remediation quote to include all PDFs.
Click Accessibility from the domain dashboard.
Click PDFs from the menu on the left.
Click Internal PDFs from the expanded selection.
Choose one of the following bulk options:
Mark all as reviewed: Select this option to mark all PDF files as reviewed.
Request PDF accessibility check for all: Select this option to request a PDF accessibility check for all PDF files.
Request remediation quote for all: Select this option to request a remediation quote for all PDF files.
Contact Support for more information. PDF tracking allows users to see which files are remediated.
Note
EU customers must contact Commonlook directly for PDF remediation quotes at their own discretion due to regulatory requirements. The PDF Remediation option continues to be available for customers in other geographical regions.
Advanced instructions
Some web security measures block the CommonLook PDF crawler that Web Governance uses. If you encounter issues with the PDF scan, allow-list these additional IP addresses and user agents.
PDF scan IP addresses
20.246.128.115
20.113.18.110
PDF scan user agents
Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36
Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko)
Web Governance