Unit tools
Unit devices
Last verified: October 3, 2026This guide is for the SAGE app (version 3) and management portal you use today. See the guide for the new apps.
A device is a credential that opens the gate, such as a fob, a barcode or a mobile credential, linked to one person at one unit. A person can have more than one device.
The Devices tab on a unit page lists the unit’s devices with their Facility Code, Device No., Device Type, Owner, Access Groups and Status. It only appears when devices are turned on for your community, and adding or editing devices needs the Manage Occupant Devices permission.
For license plate (LPR) devices, see Vehicles and plate access.
Add a device
- Go to Administration, open the unit and select the Devices tab.
- Click Add Device.
- Choose the Device Type and the Owner.
- Choose one or more Access Groups. At least one is required. For some device types you also pick a Facility Code.
- Enter the Device Number (up to 5 digits). For mobile credentials it is filled in for you.
- Check the Activation Date & Time. It starts at the current hour and can’t be in the past.
- Leave Permanent ticked for access that never expires, or untick it and set an Expiration Date & Time.
- Add a Note if you like, then click Add.
Who can own a device
The Owner list can include the unit’s occupants and tenants, people who have been invited but haven’t accepted yet, and the unit’s guests. Which of these appear depends on how devices are set up for your community.
A device for someone who hasn’t accepted their invitation is saved but doesn’t work at the gate yet. It is switched on when they accept.
Edit a device
Click a device’s row to open Edit Device. The device number can’t be changed. Update the details and click Update.
If the button reads Sync instead, the device is saved in SAGE but hasn’t reached the gate system yet. Click Sync to send it.
Messages you might see
| Message | What to do |
|---|---|
| “Device number is already in use” | Another device already has that number. Check the number on the device. |
| “Device number must be 5 digits or less” | Enter a shorter number. |
| “At least one access group is required” | Choose an access group. |
| “No available mobile credentials.” | Your community has no free mobile credentials. Contact support. |
| “Activation date & time cannot be in the past” | Set the activation to now or later. |
| “Expiration date & time must be after activation date & time” | Move the expiration later, or tick Permanent. |
Need help?
Questions? Contact us at support@sagesystems.io.