Specify data to synchronize

You can specify the data to synchronize from your school information system to Classroom and G Suite for Education. By default, Google School Directory Sync (SDS) syncs only Classroom classes, but you can also sync your G Suite for Education domain, including organizational units, user accounts, and groups.

Before you begin: Decide what to sync

  1. Click General Settings.
  2. Choose an option:
    • To sync only Classroom classes, keep the Synchronize only Google Classroom classes box checked.
    • To sync to Classroom and G Suite for Education, uncheck the Synchronize only Google Classroom classes box and select what you want to sync.
  3. Enter the CSV file directory path and click Validate data files.
  4. Click OK.

Option 1: Sync only Classroom classes

When you sync classes, the name of the class, students enrolled, and teachers and co-teachers are synced.

Sync all classes
  1. On the left, click Classes.
  2. Keep the Synchronize all classes box checked.
  3. If a student or teacher is not found in the CSV file, you can keep them in or remove them from Classroom. Select the Do not remove or Remove option.
  4. If a class is not found in the CSV file, you can keep, archive, or delete it from Classroom. Select the Delete, Archive, or Do not delete option.
  5. If you chose to delete or archive classes, you can set a limit to the number deleted or archived. Enter a percentage or number of classes.
  6. Go to Next steps to set exclusion rules.
Sync selected classes
  1. On the left, click Classes.
  2. Select Synchronize selected classes.
  3. In the Classes to synchronize box, enter a CSV list with the source IDs of the classes. For example, CLASS_01, CLASS_05, CLASS_20.
  4. If a student or teacher is not found in the CSV file, you can keep them in or remove them from Classroom. Select the Do not remove or Remove option.
  5. If a class is not found in the CSV file, you can keep, archive, or delete it from Classroom. Select the Delete, Archive, or Do not delete option.
  6. If you chose to delete or archive classes, you can set a limit to the number deleted or archived. Enter a percentage or number of classes.
  7. Go to Next steps to set exclusion rules.

Option 2: Sync to Classroom and G Suite for Education

You can also sync information from your school information system to G Suite for Education. If you want, you can specify by organizational units, user accounts, and groups.

What can you sync or not sync?
School information system G Suite domain Sync? Notes
Organizational units
  • Teachers by school
  • Students by school
Organizations Organizations in a G Suite for Education domain contain multiple users.
You can organize users by department, location, or other category.
Users Users In a G Suite for Education domain, users are organized by email address.
Sections, classrooms, and rosters Groups Sections, classrooms, and rosters correspond to public groups in a G Suite for Education domain.

What's not synced?

  • User aliases.
  • Shared contacts.
  • Calendar resources, such as rooms and projectors.
  • Passwords—SDS creates passwords for new users only, not for existing users.

    SDS only provisions passwords that are stored in SHA1 or MD5 format with no salted hashes. To bypass this, you can manage passwords separately or use single sign-on for authentication.

  • Messages and calendar data—If you need to migrate legacy messages and calendar data, use a migration tool that migrates data for other IMAP servers.
  • Personal contacts—If your users want to import personal contact information, they can use a client-based migration tool such as G Suite Migration for Microsoft® Outlook®.
1. Specify organizational units to sync
  1. Click Organizational units.
  2. You can sync by student, teacher, or both. Check the Org units of students by school box, Org units of staff by school box, or both.
  3. If organizations are not found in the CSV files, you can opt to delete them from G Suite. If you want to delete them, select the Delete option.
  4. If you chose to delete organizations, you can set a limit to the number deleted. Enter a percentage or number of organizations.
2. Specify user accounts to sync

If you synchronize user accounts, you can set a policy for default passwords for new users. Then, you can force users to change the default password the first time they sign in. You can also set a limit to the number of users or classes that are deleted during a sync.

  1. Click User Accounts.
  2. If you want users to change their password the first time they sign in, check the box and enter a default password for new users to use.

    Note: The default password can contain the following user attributes: givenName, familyName, userId, and identifier. It can’t contain nested or unbalanced brackets. Example: ChangMe_anne_marconi

  3. If a student or teacher isn't found in the CSV files, you can keep, suspend, or delete them from Classroom. Select the Delete, Suspend, or Do not delete option.

    Important: Disabling Don't suspend or delete Google domain admins not found in data files can lead to Google domain admins getting suspended or deleted if they're not found in data files. This could lead to you losing access to your Google domain control panel.

  4. If you chose to delete users from Classroom, you can set a limit to the number deleted. Enter a percentage or number of users.
3. Specify groups to sync

You can specify groups you want to include and delete groups in your Google domain that aren’t in data files. If a group with the same email address exists in your school information system directory, SDS adds any new members to the group in your G Suite for Education domain.

Note: SDS automatically detects groups that users create in your G Suite for Education domain and does not delete or overwrite them.

  1. Click Groups.
  2. Next to the groups you want to synchronize, click Configure.
  3. (Optional) Enter the group email prefix or suffix.
  4. Click OK.
  5. If a group is not found in the CSV files, you can keep them or delete them from G Suite. Select the Delete or Do not delete option.
  6. If you chose to delete groups, you can set a limit to the number deleted. Enter a percentage or number of groups.

Next steps

You can omit specific classes, organizational units, users, or groups from a sync. For details, see Set exclusion rules.

Was this helpful?
How can we improve it?