Overview
Staff can add a keycard to a door directly from the Portal Staff App (Tryportal), set when it works, and choose who uses it.
Keycards added here are the same keycards you see on the door's Credentials tab in the Portal Dashboard. Changes made in either place appear in the other automatically.
Before You Start
Keycard credentials are enabled for your property. Keycard credentials (keycards, key fobs and tags) are enabled for each property by the Portal support team. If you can't see the Keycards option on any door, contact Portal support and ask them to enable keycard credentials for your property. See Troubleshooting / FAQs.
Your keycards are registered. A keycard must be registered before it can be added to a door. Only registered keycards appear in the list when you add one. See How to Add Keycards/Tags.
You are logged in to the Portal Staff App (Tryportal).
The lock on the door supports keycards. The Keycards option only appears for these locks.
Your phone is connected to the internet. The app doesn't save changes offline.
How to Open Keycards
Open the Portal Staff App and go to Doors.
Tap the door.
Tap the three-dot menu (top-right) and open Access & Settings.
Under Access, tap Keycards.
The list shows the door's keycards, newest first. If the door has none yet, you'll see No keycards yet.
How to Add a Keycard
Tap +.
Enter a Label.
Under Keycard, choose the card in one of these ways:
Pick a registered keycard from the list.
Type the card's serial number. If it matches a registered card, the card's name shows under the field.
Android only: tap the scan button and hold the card against your phone (NFC).
Tap Access period and set the start and end (see Setting the Access Period).
Optional: add Users. Their name will show in the audit logs.
Tap Add.
You return to the list with the message The keycard has been created. The new keycard appears at the top with a New badge.
Setting the Access Period
The access period starts now by default.
Tap a duration shortcut to set the end: 1 day, 1 week, 1 month or 3 months.
If your property has default check-in and check-out times, Check-in and Check-out shortcuts also appear.
Or pick the dates on the calendar and set the times. Tap the same day twice for a one-day period.
Tap Done.
The card stops working on this door after the end.
Adding Users
You can add users when you create the keycard or later.
Open the keycard (or the Add Keycard form).
Under Users (optional), tap + Add.
Select people from the list, or search by name. The list shows staff; searching also finds guests.
Tap Done.
On an existing keycard, tap Save.
You can select up to 50 people.
Finding a Keycard
Search: Tap the search icon to search by label or serial number.
Filter: Use the Users chip to show keycards for specific people.
If nothing matches, tap Show All to clear the filter or search.
Viewing a Keycard
Tap a keycard to open its details: the serial number (with Copy), the card name, status, access period, label and users.
Keycard Status
Not on lock yet: The lock hasn't received the keycard yet.
Ready: The keycard is on the lock.
Failed: The lock didn't receive the keycard. The details page shows the reason.
Still on lock / Removing from lock: The keycard was revoked, but the lock hasn't removed it yet.
Keycards that aren't on the lock yet, are being sent, or failed show a status mark in the list.
Editing a Keycard
Open the keycard.
Change the Label, Access period or Users.
Tap Save.
Save is only active when something has changed. If you leave with unsaved changes, the app asks first.
The start and end can be changed until the keycard starts; after that, only the end. Revoked and ended keycards are read-only.
Revoking a Keycard
Open the keycard.
Tap the three-dot menu and select Revoke.
Confirm.
Important: If the lock is offline, the card keeps working until the lock reconnects and removes it.
The keycard stays in the list as Revoked.
Troubleshooting / FAQs
Portal: I can't find where to add a keycard or key fob, even though I have full permissions (Owner / General Manager)
If you can't see the Keycards option or Keycard tab on any door in the Portal Staff App, and keycards aren't available in the Portal Dashboard either, keycard credentials (keycards, key fobs and tags) are not enabled for your property yet. Keycard credentials can only be enabled by the Portal support team. Contact Portal support and ask them to enable keycard credentials for your property. Once they are enabled, the keycard options appear in both the Staff App and the Dashboard.
Portal: I don't see Keycards in Access & Settings
Check whether Keycards appears on your other doors:
Keycards is missing on every door: keycard credentials are not enabled for your property. Contact Portal support to enable them.
Keycards appears on other doors but not this one: the lock on this door doesn't support keycards.
Portal: There are no keycards to pick from
Your keycards haven't been registered yet. Register them first, then add them to the door. See How to Add Keycards/Tags. If you can't find the Keycard tab to register them, keycard credentials are not enabled for your property — contact Portal support.
Portal: "This keycard is not available. Choose a different one."
The card is already in use. Choose a different card.
Portal: I can't tap Add
Check that a Label is entered and a keycard is selected. The field with the problem shows an error.
Portal: I don't see a scan button
Scanning a card with NFC is available on Android only. On iPhone, pick the card from the list or type its serial number.
Portal: The keycard says Not on lock yet
The lock hasn't received the keycard yet. Check the door's Status in Access & Settings.
Portal: Resync is greyed out
The lock is still retrying. Resync becomes available once the retry ends, and then sends the keycard again.
Portal: I revoked a keycard but it still opens the door
The lock was offline. The card is removed once the lock reconnects. Until then the keycard shows Still on lock or Removing from lock.
Portal: "Keycards did not load"
Tap Retry. Check your internet connection.
Portal: "Couldn't connect. Check your internet connection and try again."
The change wasn't saved. Reconnect and try again.