Clever Library - Overview

Use this page to decide whether Clever Library is the right integration path for your app and understand what it includes.

☝️

District integrations take precedence

A Clever Library integration can only exist for a user if there is no district-level integration for that user. If a user belongs to a district that is already connected with your application, the district-level connection takes precedence over the Clever Library connection.

If you want to explore workarounds for this behavior, contact [email protected].

Overview

Clever Library is a teacher-managed integration path. Teachers can find your app in the Clever Library, authorize data sharing, and provision accounts for themselves and their students at the classroom level.

Use Clever Library when you want to support teacher-driven sign-up and classroom rostering without requiring a district-managed integration.

📘

Not sure if you're in the right place?

This page covers Clever Library. If you want an overview of Clever Single Sign-On, see Clever Single Sign-On - Overview.

Clever Library is a good fit if...

Clever Library is usually a good fit for your application if:

  • You already have a user registration or sign-up flow.
    • The Clever Library authorization flow can be added to your existing registration flow to reduce manual data entry.
  • You support teacher-created classes and student provisioning in your application.
    • A common implementation is to add an option such as "Sync Classes via Clever."
  • You can authenticate users with limited student data.
    • Student email addresses are not available through this integration type.
    • See https://clever.com/schema for the fields available with Clever Library.
  • You sell your product directly to teachers.
    • Clever Library is a teacher-authorized, bottom-up integration path rather than a district-managed integration.
  • You support a student experience.
    • Apps in Clever Library are usually built for classroom use by teachers and students.
    • Admins do not have access to Clever Library integrations.
📘

Clever Library apps must offer free access

Clever Library integrations must offer a free trial, demo, or freemium experience.

Available features

Testing suite and integration guide

Your developer dashboard includes an integration guide and a step-by-step testing wizard for validating your Clever Library integration.

Marketing collateral

Your Clever Library listing can include screenshots and other product marketing collateral. This collateral is required for Clever Library certification.

To see an example, browse apps in the Clever Library.

Dashboard access

As a Clever application, you get a developer dashboard with access to basic SSO settings, credentials, and application profile fields.

You do not get access to SSO troubleshooting tools for production users through the dashboard. If you need help troubleshooting production user issues, use https://support.clever.com.

Scopes and field access

Clever Library provides classroom rostering data at no cost, but the available data is limited. After a teacher authorizes the connection, your app can access:

  • teacher first name, last name, email address, and Clever ID
  • the teacher’s sections
  • section names, subjects, and grades
  • students in the teacher’s shared sections
  • student first name, last initial, and grade
🚧

Student email is not available

Student email addresses are not available through Clever Library. If your app requires student email, one workaround is to ask students to provide it the first time they sign in.

Cost

Clever Library is free to build.


What’s Next

If you are interested in setting up a Clever Library integration, see Setting up Library SSO and Rostering