Install Hāpara Highlights Follow
This article helps administrators install Hāpara Highlights by choosing the correct setup path for Chromebooks, managed Windows/Mac devices, Microsoft ID devices or non-managed devices.
Who this is for
Admins
Teachers can use the verification and common errors sections to check why a student may not appear online in Highlights.
Summary
To install Hāpara Highlights, admins need to deploy the student extension, confirm browser and device policies, allow required Hāpara network traffic and verify that students appear online. Start by choosing the setup path that matches how your school manages student devices.
Before you start
Confirm the following before you roll out Highlights:
-
Students are in the correct Student OU, user group or device group.
- Students are using the supported browser for your school’s setup.
- Students sign into the browser with their school account.
-
The Hāpara Highlights extension is force-installed for students.
- Required Hāpara and Google URLs are allowed through your firewall, web filter and network controls.
- Highlights is enabled in the Hāpara Admin Console.
- A test student account has been checked before a full rollout.
Choose your setup path
Use the path that matches your student devices and account setup.
Managed Chromebooks
Use this path when students use school-managed Chromebooks with Google Workspace accounts.
Go to: Google Admin + Chromebook setup
Managed Windows or Mac devices
Use this path when students use school-managed Windows or Mac devices and sign in with Google Workspace accounts.
Go to: Windows/Mac MDM setup
Windows devices with Microsoft ID sign-in
Use this path when students use Windows 10/11 devices and sign in with Microsoft 365 school accounts.
Go to: Microsoft ID via Intune setup
Personal or non-managed Windows/Mac devices
Use this path when students use personal devices or school devices that are not managed through an MDM.
Go to: Non-managed device setup
Students appear Offline, blank or missing in Highlights
Use the verification and common errors sections in this article.
Decision path: managed vs non-managed devices
- Are the student devices managed by the school?
- If yes, continue to step 2.
- If no, use the Non-managed device setup section.
- What type of device are students using?
- Chromebook: Use Google Admin + Chromebook setup.
- Windows or Mac: Continue to step 3.
- What account type do students use?
- Google Workspace account: Use Windows/Mac MDM setup.
- Microsoft 365 school account: Use Microsoft ID via Intune setup.
- Are students signed into the browser with their school account?
- If yes, continue with extension and network verification.
- If no, ask students to sign into the browser first. Signing into Gmail, Google Docs, Outlook or another website is not the same as signing into the browser.
Google Admin + Chromebook setup
Use this path for managed Chromebooks with Google Workspace student accounts.
Steps to follow
- Sign in to the Google Admin Console as an administrator.
- Confirm students are in the correct Student OU.
- Confirm the required Google Workspace and Chrome policies are applied to the Student OU.
- Enable screenshot permissions for Highlights if your school uses screen visibility.
- Force-install the Hāpara Highlights extension for the Student OU.
- Confirm the extension is set to force install.
- Add the required Hāpara URLs to your firewall, web filter and network allowlist.
- In the Hāpara Admin Console, confirm Highlights is enabled.
- Sign into a Chromebook with a test student account.
- Open a class in Highlights and confirm the student appears online.
Windows/Mac MDM setup
Use this path when student Windows or Mac devices are managed by your school and students sign into the browser with Google Workspace accounts.
This may apply if your school uses tools such as Group Policy, Intune, Jamf or another MDM.
Steps to follow
- Confirm Google Chrome is installed on student devices.
- Confirm students will sign into Chrome with their school Google account.
- In your device management tool, configure the Chrome extension force-install policy.
- Add the Hāpara Highlights extension using the deployment details from the managed Windows/Mac article.
- Apply the policy to the correct student device group or user group.
- Allow the required Hāpara URLs through your firewall, web filter and network controls.
-
On a student device, open
chrome://policy. - Confirm the extension force-install policy is applied.
-
Open
chrome://extensions. - Confirm Hāpara Highlights is installed and managed by your organization.
- Open a class in Highlights and confirm the student appears online.
Microsoft ID via Intune setup
Use this path for Windows 10/11 devices where students sign in with Microsoft 365 school accounts.
Steps to follow
- Open the Microsoft Intune admin center.
- Create or open the browser configuration profile used for student devices.
- Add the required extension force-install settings for the browser your students use.
- Add the Hāpara Highlights extension using the deployment details from the Microsoft ID article.
- Assign the profile to the correct student users or devices.
- Allow the required Hāpara URLs through your firewall, web filter and network controls.
- Have the device check in to Intune.
- Restart the browser if the extension does not appear.
- Confirm the Hāpara Highlights extension is installed and enabled.
- Open a class in Highlights and confirm the student appears online.
Non-managed device setup
Use this path when students use personal or non-managed Windows/Mac devices.
For Highlights to work on non-managed devices, students must sign into the browser with their school account so the school’s browser policies can apply.
Steps to follow
- Sign in to the Google Admin Console as an administrator.
- Go to the Chrome user and browser settings for the Student OU.
-
Turn on Chrome management for signed-in users.
- Apply the required user policies when students sign into Chrome.
- Force-install the Hāpara Highlights extension for the Student OU.
- Ask students to open Chrome.
- Ask students to sign into Chrome with their school Google account.
- Ask students to confirm the Hāpara Highlights extension appears in Chrome.
- Open a class in Highlights and confirm the student appears online.
Teacher quick check for personal or BYOD devices
Teachers can ask the student to check the following:
- Open Chrome.
- Confirm they are signed into Chrome with their school account.
- Open the Chrome extensions menu.
- Confirm the Hāpara Highlights extension is installed and enabled.
- Refresh Highlights.
- Check whether the student now appears online.
If the student is signed into a personal browser profile, ask them to switch to their school profile or sign into Chrome with their school account.
Network allowlist requirements
Highlights must be able to connect to Hāpara and Google services. Add the required Hāpara URLs to your firewall, web filter and network allowlist.
Check the Allowed list URLs for Highlights article for the current list of URLs.
Make sure your network allows:
- Required Hāpara domains
- Required Google domains
- HTTPS traffic
- WebSocket traffic where required
- Traffic from student devices on school networks
If many students are affected at the same time, check network filtering, firewall rules and recent policy changes before troubleshooting individual devices.
Verify the installation
Use these checks after any installation or policy change.
- Sign in with a test student account.
- Confirm the student account is in the correct Student OU, user group or device group.
- Confirm the student is signed into the browser with their school account.
- Confirm the Hāpara Highlights extension is installed.
-
On managed Windows/Mac devices, check
chrome://policy. -
On managed Windows/Mac devices, check
chrome://extensions. - Confirm required Hāpara URLs are not blocked.
- Open a class in Highlights.
-
Refresh the student tile.
- Confirm the student appears online.
Common errors and what to check
Student appears Offline
Check whether the student:
- Is connected to the internet.
- Is using the supported browser.
- Is signed into the browser with their school account.
- Has the Hāpara Highlights extension installed.
- Is using the correct school account.
- Is in the correct Student OU, user group or device group.
- Is affected by time or IP restrictions.
- Is using a personal browser profile instead of a school profile.
Student tile is blank
Check whether:
- The student is actively using the browser.
- Screenshot permissions are enabled.
- The student is within allowed school hours.
- The student is on an allowed network.
- Required Hāpara URLs are blocked by a firewall or filter.
- A recent policy or network change affected multiple students.
Extension does not install
Check whether:
- The extension policy is applied to the correct OU, user group or device group.
- The extension is set to force install.
- The device has received the latest policy.
- The browser has been restarted.
- The student is signed into the browser with the correct school account.
- The student is using the correct browser for your setup.
- Your firewall or filter is blocking extension installation or Hāpara services.
Student can bypass Highlights
Review your Google Admin or MDM policies for:
- Incognito mode.
- Guest browsing.
- Browser sign-in requirements.
- Multiple account sign-in.
- Developer tools.
- Extension removal.
- Browser task manager access.
- Unmanaged browser profiles.
Additional tips
- Test Highlights with a small group before rolling it out to all students.
- Keep Chromebook, Windows/Mac MDM, Microsoft ID and non-managed device instructions separate so admins can follow the correct setup.
- Use this article as the starting point when you are unsure which installation path applies.
- If only one student is affected, check the student’s browser sign-in, account and extension status first.
- If many students are affected, check network allowlists, device policies and recent admin changes first.
Related articles
- Deploy Highlights extension to managed Windows and Mac devices
- Deploy Hāpara Highlights extension for Microsoft ID sign-in
- Setting up Hāpara Highlights on non-managed devices
- Allowed list URLs for Highlights
- Signing into Chrome vs signing into your Google account
- Strengthening Highlights and preventing student loopholes