Deploy the ReadingVox Chrome extension

• Google Workspace admin with permission to manage Chrome apps and extensions (a super admin has it). Students must sign in to their Chromebook, or to Chrome, with their school Google account.
• Your ReadingVox license key. We email it to the account owner when your plan or pilot with Chrome extension seats starts (Institution plan with the Chrome extension add-on, or a School License). During a pilot, up to 200 students can activate until your first payment.
• The extension ID: the ReadingVox extension ID (email [email protected] for it while our Chrome Web Store listing is being finalized).
• A test student account in the same organizational unit (OU), so you can check it before students do.

1. 1

   Step 1: Open Apps & extensions for users

   Sign in at admin.google.com. Go to Devices → Chrome → Apps & extensions → Users & browsers. In the left panel, select the organizational unit with your students.

   admin.google.com/ac/chrome/apps/user

   Organizational units

   • yourschool.org
   • Staff
   • (Step marker 2)2Students
   • Grade 6

   (Step marker 1)1Users & browsers

   Kiosks

   Managed guest sessions

   Requests

   Apps and extensions installed for users in this organizational unit

   (Step marker 3)3+

2. 2

   Step 2: Add ReadingVox by its extension ID

   Hover over + and choose Add Chrome app or extension by ID. Make sure From the Chrome Web Store is selected, paste the ID, and click Save.

   admin.google.com/ac/chrome/apps/user

   Add from Chrome Web Store

   (Step marker 1)1

   Add Chrome app or extension by ID

   Add by URL

   ---

   Source

   From the Chrome Web Store

   (Step marker 2)2Extension ID

   EXTENSION_ID (see note)

   Cancel

   (Step marker 3)3Save

   Where's the extension ID?

   Our Chrome Web Store listing is being finalized. Email [email protected] and we'll send you the ID to paste here.
3. 3

   Step 3: Set it to Force install and add the license policy

   Click ReadingVox in the list to open its settings panel on the right. Set Installation policy to Force install (or Force install + pin to browser toolbar, so students always see the icon). In Policy for extensions, paste the JSON below with your license key in place of YOUR_LICENSE_KEY. Then click Save at the top right.

   Policy for extensions (JSON)

   Copy

   {
     "licenseKey": {
       "Value": "YOUR_LICENSE_KEY"
     }
   }

   admin.google.com/ac/chrome/apps/user

   ReadingVox

   EXTENSION_ID (see note)

   Force install

   (Step marker 1)1Installation policy

   Force install + pin to browser toolbar

   (Step marker 2)2Policy for extensions

   { "licenseKey": { "Value": "YOUR_LICENSE_KEY" } }

   (Step marker 3)3Save

   The policy accepts two settings: licenseKey (required) and apiEndpoint. Leave apiEndpoint out unless our support team asks you to set it.

4. 4

   Step 4: Let students sign in with Google (if you restrict third-party apps)

   The extension signs students in with their school Google account, so it can count license seats and read Google Docs and Slides they open. If your domain restricts third-party app access (Google does this by default for users designated under 18 in Google Workspace for Education), mark ReadingVox as trusted:

   1. Go to Security → Access and data control → API controls → Manage Third-Party App Access.
   2. Click Configure new app and search for this OAuth client ID: 31765744281-3m29c5qv6fp6l6le7fe7gkvoqfk6ktkp.apps.googleusercontent.com
   3. Choose your students' OU and set access to Trusted.

   admin.google.com/ac/owl

   (Step marker 1)1Configure new app

   Search by app name or OAuth client ID

   31765744281-3m29c5qv6fp6l6le7fe7gkvoqfk6ktkp.apps.googleusercontent.com

   ReadingVox

   Web application · OAuth client

   (Step marker 2)2Access to Google data

   Trusted

   If you skip this and access is restricted, students see a Google message saying the app is blocked when they sign in.

1. Sign in to a Chromebook (or Chrome) as your test student. Policies can take a few minutes to arrive; to speed it up, open chrome://policy and click Reload policies.
2. On chrome://policy, ReadingVox's extension ID should be listed with a licenseKey policy. On chrome://extensions, ReadingVox shows as installed by your administrator.
3. Click the ReadingVox icon in the toolbar. On a managed Chromebook it activates by itself with the student's Google account. If it asks, the student clicks Sign in with Google; the license key is already filled in.
4. Open any article or a course in your LMS, select some text, and press play.

Each student who activates uses one seat on your license. Managed Chrome on Windows and Mac follows the same policy when students sign in to Chrome with their school account and your Admin console applies user policies to signed-in Chrome browsers.

These platforms don't have a native ReadingVox install yet, so students use the extension: they open the course in Chrome as usual and use the ReadingVox button, or select text and choose listen.

• It works on the page the student is viewing, including Google Docs and Slides they have access to.
• Some LMS content opens inside an embedded frame (for example certain Brightspace content topics or publisher tools). If a frame's text isn't picked up, open that content in its own tab and use ReadingVox there.
• The LMS mobile apps, iPads, and browsers other than Chrome aren't supported.

What works natively in each LMS

1. In the Admin console, go to Devices → Chrome → Apps & extensions → Users & browsers and select the same OU.
2. Click ReadingVox and either delete it from the list or set Installation policy to Block. Click Save.
3. The extension is removed from students' browsers the next time their policies update (usually within a few hours, or at next sign-in).