Skip to main content
Pepperdine | Community

Grackle Docs Accessibility Checker

Grackle Docs: An accessibility checker for your Google Docs

Overview

Grackle Docs is an extension for Google Workspace (Docs, Slides, and Sheets) that will scan your Google document for accessibility issues. It checks for several standards and will allow you to fix or tag issues. Once corrected, you will also have the option to export the fixed document as an accessible PDF file.

Before You Begin

Prerequisites

Pepperdine University has licensed Grackle Docs for the entire institution. To take advantage of this powerful tool, you must meet the following requirements:

  • You must be a current or active student, faculty, or staff member.
  • You must be logged into your Pepperdine Google account.
  • Your Pepperdine Google account must be the default account in the active web browser session; if necessary log out of all Google accounts and log back in with your Pepperdine account first. Or use different browsers for personal and work purposes.

Accessibility Matters

Accessibility checkers are crucial tools for testing purposes, but they are not perfect. Grackle Docs does an excellent job and will catch most issues. Be prepared that you will likely still need to do a manual check (read and review the document to verify color use, double-check reading order, avoid generic links, etc.) to ensure your content meets digital accessibility requirements.

 

Install Grackle Docs

  1. Go Pepperdine Google Drive.
  2. Open or create a Google Doc, Google Sheets spreadsheet, or Google Slides presentation.
  3. Go to the Extensions menu.
  4. Select Grackle Docs and choose Launch.
  5. For the account, choose your Pepperdine University account (do not use a personal Gmail account).
  6. Allow Grackle Docs permission to access your Google Docs.
  7. Done.
  8. If necessary, return to the Extensions menu and select Launch again to start the checker.

Access Grackle Docs

  1. Make sure you have already installed Grackle Docs (see above).
  2. Open a Google Doc, Sheets spreadsheet, or Slides presentation.
  3. Select the Extensions menu.
  4. Select Grackle Docs and choose Launch.
  5. The Grackle Docs accessibility checker will appear as a right-hand sidebar in your web browser.

Fix Issues in the Grackle Docs Accessibility Scan

Upon launching Grackle Docs, a window panel will appear on the right side of the computer browser window. If you are logged into your Pepperdine Google account properly, it will automatically begin scanning the current document. Grackle Docs scans and categorizes the content into five major categories: Images, Headings, Tables, Landmarks, and Content.

  1. Review the scan results.
    • If there is a red circle in any section, you must correct the mistake to improve the document’s accessibility. To fix your document, locate the red "X" next to an item, select the item, click "Locate," and follow the prompt to resolve the issue.
    • If there is a yellow circle in any section, you should correct the mistake to improve the document’s accessibility. To fix your document, locate the green check mark with the red exclamation point next to an item, select the item, click "Locate," and follow the prompt to resolve the issue.
    • A check mark with a green circle indicates all items in that category passed the accessibility check. No action is needed.
  2. Correct each issue one at a time throughout the document. 
  3. After you have made all of the required edits, click the blue “Re-Check” button at the top of the Grackle Docs panel
  4. Continue to revise as needed until all checks have passed.

Export PDF with Grackle Docs

  1. Go to the Google Doc, Slides, or Sheets document.
  2. Select the Extensions menu, choose Grackle Docs, and select Launch.
  3. Important: Fix all accessibility items before exporting the PDF. Select "Re-check" to verify the document is ready.
  4. Select the Export to PDF button.
  5. If prompted, Allow Grackle Docs access to Google Drive to save the PDF.
  6. If prompted that "Some items did not pass the accessibility check...," select No (to cancel) and then fix any outstanding issues before continuing.
  7. The Progress Monitor window will appear.
  8. Select Start.
  9. Wait for the process to complete.
  10. When done, select one of the options:
    • View: Will open the PDF in Google Drive.
    • Download: Will save the file to your computer.
    • Close: Will close the Progress Monitor window.
  11. The resulting PDF can be found in the same location as the original Google document, with the same file name, but as a PDF.

Troubleshooting and FAQ

  Grackle Docs seems to be stuck scanning or does not seem to work

The most common reason is that you are not logged into your web browser session properly. Look at the footer of the Grackle Docs panel. Does the bottom say "Grackle Docs: Subscribed"? If not, then you need to fix your account login.

Your Pepperdine University Google account must be the first, primary, or default account for your current web browser session. There are a number of ways to address this issue:

  1. Log Out and Log Back In: Log out of all Google accounts and log back in with your Pepperdine University Google account as the first account. Subscription licenses look for the first or default account for authorization.
  2. Use Browser Profiles: Browsers like Google Chrome and Firefox allow you to not only log into multiple accounts, but you can set up browser profiles dedicated to specific accounts. Using a browser profile logged into Pepperdine should resolve the issue while using that profile.
  3. Use Mulitple Browsers: An easy approach is to simply dedicate one web browser for your Pepperdine work and a different web browser for personal or other accounts. For example, you might choose Google Chrome for Pepperdine and Mozilla Firefox for personal use (or vice versa).
  4. Use Incognito or Private Window: You can use an incognito or private window to log into Pepperdine Google.

If you experience issues logging into your Pepperdine Google account as the default account, please contact Tech Central at 310.506.4357.

  I fixed something, why is it still on the list? (Tip: Select "Re-Check")

The list does not update dynamically. If you want to focus efforts on the remaining issues, please select "Re-Check" to scan the document again. 

  Why does Google's "Download" as "PDF" feature not meet accessibility standards?

Always scan your Google documents with Grackle Docs and then use Grackle's "Export to PDF" feature to save a PDF version of the file. See "Export PDF with Grackle Docs" above.

Do not use the basic Google Docs option to download as a PDF ("File" menu to "Download" to "PDF Document (.pdf)"). This method will not include your hard work to add image ALT tags or structure your content properly. The standard Google download process strips out this necessary information and will not comply with accessibility standards.

  Can I scan my Microsoft Word or PDF document with Grackle Docs?

Grackle Docs only works with Google Docs, Slides, or Sheets. It does not scan Microsoft Word, PowerPoint, Excel, or Adobe PDF files.

To scan a Microsoft Office document, please use the Microsoft Office Accessibility Checker.

To scan a PDF file, please use the Adobe Acrobat Pro Accessibility Checker (limited to full-time Pepperdine employees only).


See Also


 

← Back to Google Workspace

 

Tech Central

Phone: 310.506.4357 (HELP)

Hours: 24 hours a day, 7 days a week, 365 days a year

Technology Service Request Forms

Have A Suggestion for IT?

Click to share your suggestion, anonymously if preferred, to improve Pepperdine IT.