Go Portal / Key Hub Help
Overview
The Go Portal (go.unlockos.io/{slug}) is a unified PWA portal for your facility. Unauthenticated visitors see a list of available services, while logged-in users see Key Hub — a unified key management screen that shows all your daily keys, reservations, active check-ins, and past check-ins in one place.
Key Features
- Single shareable URL for all facility apps
- Auto-redirects to the correct app when only one is active
- Displays all available apps when multiple are active
- No login required for the portal landing (Key Hub requires login)
- Works on any device (mobile, tablet, desktop — installable as a PWA)
- Backward compatible: old
facilityId-based URLs redirect here automatically
Key Hub
Key Hub is the central key management screen available to logged-in users. Tap the "Key Hub" tab in the bottom navigation to open it.
How to Access Key Hub
- Go to
go.unlockos.io/{facility-slug}. - Tap the Login button in the top-right corner.
- Enter your email address to receive a one-time passcode (OTP) and log in.
- After login, the Key Hub tab is automatically selected.
UnlockPass
When you log in to the Go Portal, you may notice UnlockPass visual cues:
| Where | What you see |
|---|---|
| Login screen | "UnlockPass" pill logo above the email input |
| Right after OTP verification | A soft teal toast: "Authenticated with UnlockPass" (shown for 3 seconds) |
| Settings tab — email row | An "UnlockPass verified" tooltip |
UnlockPass is a shared email-verification identity that works across all UnlockOS facilities. Once your email is verified at one facility, you are recognized automatically at any other UnlockOS property — no re-entry of details needed.
UnlockPass activates automatically. No special sign-up is required.
Key Hub Sections
Key Hub displays up to four sections. Sections with no keys are hidden automatically.
| Section | Contents | Actions available |
|---|---|---|
| Daily Keys | Keys from active membership subscriptions | One-tap unlock |
| Reservations | Upcoming reservations | Check in (from 24 hours before start, completed in-app) |
| Active | Currently checked-in sessions | Show QR code, check out |
| Past | Completed check-in history | View only |
Using Daily Keys (Unlock Flow)
Daily keys are available to members every day as part of their membership subscription.
- Open Key Hub.
- Locate your key card in the Daily Keys section.
- Tap the Unlock button.
- A QR code is displayed. Hold it up to the smart lock reader to enter.
- The QR code shows a validity time ("Valid until: HH:MM"). Use it before it expires.
If the Unlock button is not visible, your membership may have expired or the facility may be outside operating hours.
Checking In from a Reservation
Tapping a reservation card takes you through the entire check-in flow inside the Go app — no redirect to a separate website.
Check-in flow
- Open Key Hub.
- Your upcoming reservations are listed in the Reservations section.
- Once you are within 24 hours of the reservation start time, a Check in button appears on the card.
- Tap Check in to open the reservation detail screen.
- If the facility requires guest information, a form will appear asking for your name, contact details, and similar information. Fill it in and submit.
- After submitting the form (or immediately if no form is required), tap Check in to confirm.
- Once check-in is complete, your access code and QR code are displayed on screen. Hold the QR code up to the smart lock reader to enter.
- The checked-in session also appears in the Active section of Key Hub.
Reading the access code screen
The screen shown after a successful check-in includes:
- Access code (a numeric or alphanumeric code)
- QR code (present this to the smart lock reader)
- Expiry time (shown as "Valid until: HH:MM")
- Your reservation start and end date/time
If the QR code expires, tap Refresh to get a new code.
Troubleshooting check-in
| Situation | What to do |
|---|---|
| No Check in button visible | The button appears 24 hours before the reservation start. Come back closer to that time. |
| "Reservation not found" message | Check your reservation details and the email address you are logged in with, then contact facility staff. |
| QR code has expired | Tap Refresh to generate a new QR code. |
The Check in button will not appear until 24 hours before the reservation start time.
Viewing and Refreshing QR Codes for Active Check-ins
Active check-in sessions appear in the Active section.
Displaying the QR Code
- Find the key card in the Active section.
- If a QR code is already displayed, hold it up to the smart lock reader directly.
- If no QR code is shown, tap Show QR to fetch one.
Refreshing an Expired QR Code
QR codes have a limited validity window. When one expires:
- Tap Show QR again.
- A new QR code is fetched and displayed.
- Confirm the updated "Valid until" time before presenting it to the reader.
Checking Out
- Tap the Check out button on the active check-in card.
- You will be directed to the checkout app to complete the process.
Changing Language and Logging Out
Changing the Display Language
Tap the language toggle in the top-right corner of any screen (shown as JP / EN) to switch between Japanese and English instantly. The preference is saved in your browser.
Alternatively, use the Settings tab:
- Tap the Settings tab in the bottom navigation.
- Select your preferred language from the "Language" row.
Logging Out
- Tap the Settings tab in the bottom navigation.
- Tap the Logout button.
- Confirm the logout when prompted.
- You will be returned to the portal landing screen.
Walk-in (Drop-in Use)
Tap the Walk-in tab in the bottom navigation to be redirected to the facility's check-in app. Use this when you want to check in on the spot without a prior reservation.
Portal Landing (Unauthenticated View)
When you visit the Go Portal without being logged in, you see a list of services available at the facility.
| Icon | Service | Description |
|---|---|---|
| Checkmark | Check-in | Check in to the facility |
| Calendar | Booking | Book a space |
| Users | Member | Membership services |
| Lock | Locker | Use a locker |
| Home | Resident | Resident services |
| Monitor | Front Desk | Front desk |
If only one service is available, the portal skips the list and redirects you directly to that service.
How It Works
URL Patterns
| Pattern | Behavior |
|---|---|
go.unlockos.io/{slug} |
Portal page listing available apps, or auto-redirect if only one |
go.unlockos.io/{slug}/{app} |
Direct redirect to a specific app |
Where {app} is one of: checkin, booking, locker, resident, frontdesk.
Available Apps on the Portal
| App | URL navigated to | When shown |
|---|---|---|
| Check-in | checkin.unlockos.io/{slug} |
Active check-in configuration exists |
| Booking | booking.unlockos.io/{slug} |
Active room reservation config exists |
| Locker | locker.unlockos.io/{slug} |
Active locker reservation config exists |
| Resident Registration | resident.unlockos.io/{slug}/register |
Facility has a slug set |
| Front Desk | frontdesk.unlockos.io/{slug} |
Always shown |
Auto-Redirect Behavior
If only one app is available for your facility, visiting go.unlockos.io/{slug} skips the portal page and redirects the guest directly to that app. No intermediate step is needed.
Accessing the Short URL
The Short URL for your facility is displayed in Basic Settings on the App URL Preview panel.
- Go to Basic Settings.
- Set or confirm your facility slug in the "App URL" field.
- The Short URL (
go.unlockos.io/{slug}) appears in the preview panel below the slug field. - Use the copy button to copy the URL, or scan/download the QR code displayed there.
Security
- The portal page does not expose API keys or internal IDs.
- Old URLs that contained
facilityIdorconfigIdas query parameters are redirected to the new slug-based URLs — API keys are no longer embedded in public-facing URLs. - Rate limiting: 60 requests per minute per IP address.
- Inactive facilities return a 404 page.
FAQ
Q: No keys are showing in Key Hub
A: Verify that you are logged in with the correct email address, that your membership is active, and that you have reservations registered. Contact facility staff if the issue persists.
Q: My QR code has expired
A: Tap Show QR again to generate a fresh QR code. QR codes have a short validity window for security and are refreshed on demand.
Q: I have a reservation but there is no Check in button
A: The Check in button appears 24 hours before the reservation start time. Visit Key Hub again when you are within that window.
Q: What if a guest visits go.unlockos.io with the wrong slug?
A: A 404 "Facility not found" page is displayed. The guest should check the URL or QR code and contact facility staff if the issue persists.
Q: Can I link directly to a specific app instead of the portal?
A: Yes. Use the pattern go.unlockos.io/{slug}/{app} to link directly. For example, go.unlockos.io/sakura-mansion/checkin redirects to the check-in app.
Q: Does the portal page support English?
A: Yes. Use the language toggle in the top-right corner or the Settings tab to switch between Japanese and English.
Q: What happens if I change the slug?
A: The old go.unlockos.io/{old-slug} URL will stop working. Update any printed QR codes and distributed links after changing the slug.
Q: Is the portal URL indexed by search engines?
A: The portal page does not include noindex directives, but it is a functional gateway page, not a marketing page. Its primary purpose is operational access for guests.
Related Pages
- Basic Settings - Set your facility slug and view all app URLs
- Guest Check-in - Check-in steps for guests
- Guest Reservation - View and manage reservations
- Check-in Configuration - Configure the check-in app
- Booking - Configure the booking app
- Delivery Management - Issue resident registration QR codes
Last updated: 2026-04-19 - Added UnlockPass section (OTP login pill, authentication toast, My Page badge)