Using Schoolyear secure exam browser

Schoolyear lets schools run online tests in a secure browser. When Schoolyear is connected to Examplary, teachers can require students to open a test through the Schoolyear Browser before they can start.

This guide explains how organization admins set up the integration, how teachers enable it for a test, and what students see when they take the test.

Set up Schoolyear for your organization

An organization admin or owner only needs to connect Schoolyear once.

1. Open Examplary and go to Account.
2. Open Integrations.
3. Select Schoolyear.
4. Enter the API secret from Schoolyear.
5. Enter the API endpoint. In most cases this is https://api.schoolyear.app.
6. Click Connect.

Examplary checks the credentials with Schoolyear before saving the connection. When the setup succeeds, the Schoolyear card shows Connected.

Enable Schoolyear for a test

After Schoolyear is connected, teachers can enable it per test.

1. Open the test in Examplary.
2. Open Settings.
3. Set a start date and an end date for the test.
4. In the security section, enable Require the use of Schoolyear.
5. Save the test settings.

Examplary creates the matching test in Schoolyear when the settings are saved. If you later change the test name, start date, end date, or browser spell-check setting, Examplary updates the Schoolyear test as well.

Configure the test in Schoolyear

When Schoolyear is enabled for a test, Examplary shows two buttons in the test settings:

• Configuration opens Schoolyear's configuration screen for that test.
• Exam dashboard opens Schoolyear's live dashboard for monitoring sessions.

Use Configuration for Schoolyear-specific browser settings. Use Exam dashboard during the test to follow student sessions in Schoolyear.

These links are generated fresh every time you click them, so reopen the button from Examplary whenever you need to access Schoolyear.

Share the test with students

Schoolyear tests must be taken by signed-in Examplary students. Before the test starts:

1. Make sure the students have Examplary student accounts.
2. Invite the students or groups who should take the test.
3. Share the signed-in test link with those students.
4. Ask students to install the Schoolyear Browser if your school has not already installed it for them.

Avoid relying on an anonymous public link for Schoolyear tests. If a student opens a public link while signed out, Examplary asks them to sign in before continuing.

What students see

When a student opens a Schoolyear-protected test, Examplary checks whether they are signed in and whether the test is already running in the Schoolyear Browser.

The normal flow is:

1. The student opens the Examplary test link.
2. If needed, the student signs in to their Examplary account.
3. The student clicks the Open Schoolyear button.
4. Schoolyear opens the secure browser and launches the test.
5. The student starts the test in Examplary from inside the Schoolyear Browser.

If a student tries to start the test outside Schoolyear, Examplary blocks the attempt and asks them to open the test in Schoolyear. If a teacher or admin opens the student test flow, Examplary explains that only students can take the test.

Turn off Schoolyear for a test

To stop requiring Schoolyear for a test, return to the test settings and disable Require the use of Schoolyear.

Examplary archives the matching Schoolyear test. This removes it from Schoolyear's planning, but it does not forcibly close students who are already in an active secure-browser session.

You can enable Schoolyear again later. Examplary will reuse the existing Schoolyear test and sync the latest settings.

Troubleshooting

I cannot find Integrations

Only organization admins and owners can configure integrations. If you are an admin or owner and still do not see Integrations, contact Examplary support.

Schoolyear will not connect

Check that the API endpoint starts with https:// and that the API secret is copied from Schoolyear without extra spaces. If the credentials still fail, ask Schoolyear to confirm the secret and endpoint for your organization.

I cannot enable Schoolyear for a test

Set both the start date and end date in the test settings, then save again.

A student is asked to sign in

This is expected for Schoolyear tests. The student must use an Examplary student account so Examplary can create a secure Schoolyear session for them.

A student sees "Only students can take this test"

They are signed in with a teacher or admin account. Ask them to sign out and sign back in with their student account.

A student cannot start the test

Ask them to open the test through the Open Schoolyear button in Examplary. Starting the test directly in a normal browser is blocked for Schoolyear-protected tests.