Google Workspace for Education License Management Tool
The Google Workspace for Education License Management Tool is a Google Sheets-based tool that allows administrators to manage and automate Education Plus, Education Standard, and Teaching and Learning Upgrade license assignment in bulk. The tool is offered by AppsEvents, a Google for Education partner, at no charge to global educational institutions who use Google Workspace for Education.
The License Management Tool allows Workspace for Education administrators to:
Easily assign licenses to users based on group membership (including dynamic groups) or organizational unit (OU)
Ensure licenses are assigned to active users
Manage licenses manually (one-time syncing) or automatically (continuous syncing)
Simply copy the Google Sheet below to get started!
Getting started
To get started, please see the instructions and best practices document, or review the steps below:
Preparing the tool
Note: if you currently license your users automatically using the Admin console, GAM, or GCDS, please disable those methods before using this tool.
Make a copy of the tool. Make sure to use your Google Workspace for Education admin account to copy the Sheet.
The tool requires that you select which licenses you have and enter the total number of licenses you’ve purchased. To do so, navigate to the Subscriptions section of your Admin Console.
Calculate the total number of licenses purchased, by adding the number of licenses available to the number of licenses assigned for each license type.
In your copy of the license management tool, navigate to the first tab (“Instructions”) and enter the total number of licenses of each type you have purchased (Column B: Purchased Licenses). For any license type that you have not purchased, leave the count as “0.”
The "Assigned Licenses" and "Available Licenses" columns will be updated automatically by the tool after you complete your first sync.
The final step to set up the tool is to navigate to the "Sync Licenses" menu in the menu bar and select “Setup.”
First, you will be prompted to accept permissions.
Click “Continue”
Select your Google account on the next screen
Finally, review the permissions and click “Allow”
Once you’ve authorized the tool, select the “Sync Licenses” menu again and select “Setup” again to complete the setup process.
Defining Group and/or OUs to update
Next, you need to define which groups and/or OUs you want to sync. Switch tabs to the “Groups OrgUnits to Sync” tab.
In Column A, enter the group email address of the group or OU path to which you want to add or remove licenses. Use the following examples as a guide:
Group (enter the full email address): students@school.edu
OU: “OU-name” or “OU-name/sub-OU” for sub-OUs (without the quotes)
In Column B, you can optionally enter the email address of any group you’d like to exclude from the update.
For example, if you wanted to provide a particular license to all your users except for your part-time staff, you could add the group email address of your part-time staff in Column B.
Note: this column only accepts groups (not OUs), but you can use groups in Column B when using OUs in Column A.
In Column C, select the license you want to update.
Note: Selecting “Google Workspace for Education Fundamentals” with an action type of “Sync” or “Add” (see #5 below) will remove any paid license assigned to users in that group or OU. You cannot remove Education Fundamentals licenses.
In Column D, select the action to perform: Sync, Add, or Remove.
Sync: Selecting “Sync” will add licenses to any member of the group or OU who does not currently have the license, as well as remove the license from any user who has been removed from the group/OU since the last time the tool updated the licenses.
Add: Selecting “Add” will add the license to any member of the group or OU who does not currently have the license.
Remove: Selecting “Remove” will remove the license from any member of the group or OU who currently has the license.
In Column E, select whether you would like to update the licenses manually (one-time update) or whether you would like to update licenses continuously through a daily automated sync (Automated).
If you would like to remove licenses from accounts which have been inactive (i.e. haven’t logged in), enter the number of days a user would need to be inactive before the license is removed (Column F).
Note: it’s best to use this column when selecting “Sync” in Column D.
In Column G, you can select the checkbox if you would like to provision licenses to suspended user accounts.
Note: it’s best to use this column when selecting “Sync” in Column D.
Repeat steps 2 through 8 for each group/OU you want to update (each in a new row).
Starting an update
Once the groups/OUs are configured, select the “Sync Licenses” menu and select “Run License Sync”.
First, you’ll see a green bar at the top. Next, you’ll see a message box in the lower right stating that the update will start shortly. Once the update starts, the Sheet will display “Syncing” in the status column (Column H), while the tool is running. Once the tool has updated licenses, the status will change to “Complete” and log entries will be updated in the “Logs” and “AssignmentLogs'' tabs.
Column I (“Assigned”) will display the number of licenses assigned by the tool.
Note: this column will only show when licenses have been added (assigned), not removed.
Column J (“Total Available”) will display the total number of licenses available for the license specified in Column C.
Frequently asked questions
How long does license synchronization take?
When applying licenses for the first time, the tool can handle approximately 10,000 per day. The tool can process approximately 5,000 license changes (adds + removes) per day or approximately 360 licenses per hour.
Can I use this tool along with other license assignment methods (Admin console, GAM, GCDS)?
We do not recommend using multiple methods for license assignment simultaneously. For example, if you’re currently using the Admin console, GAM, or GCDS to manage licenses automatically, please disable those methods before using the License Management Tool.
If you use other methods on an as-needed (one-off) basis, you can continue to use them alongside the License Management Tool. For example, you could use the Admin console for initial license deployment, then use the License Management Tool for ongoing maintenance and synchronization.
How do I stop updates that are in progress? How do I cancel automatic synchronization?
Open the License Management Tool sheet.
Go to the 'Sync Licenses' menu in the top menu bar.
Select 'Reset'. This will remove all triggers, disabling both automatic and manual syncs.
Can I see what changes the tool will make before actually making changes?
After setting up the groups and OUs you'd like to sync, go to the “Sync Licenses” menu and select “Simulate License Sync.” You can then switch to the "SyncSimulation" tab to preview what changes would be made.
How can I track changes made by the tool?
All changes are recorded on the “AssignmentLogs” tab. You will also receive a daily email summarizing any license additions or removals.
How do I update the License Tool?
You will be automatically notified of new versions when opening the License Management Tool sheet. When a new version is available, select “Update” from the “Sync Licenses” menu in the top menu bar.
For the script to update you need to ensure the AppScript API is set to On by going to https://script.google.com/home/usersettings
Help
We're here to support with any questions, comments or feedback you might have.
For support, please email help@gwfelicensetool.com and we'll get back to you as soon as possible.
For feature requests and general feedback, please fill out this form.