Basic Settings Help

Overview

Basic Settings manages common settings that apply to the entire facility. Configure currency, tax rates, business hours, team members, and more.

Basic Settings screen

Key Features

  • Facility name, currency, and timezone settings
  • App URL (facility slug) settings
  • App URL preview panel with copy buttons and QR code
  • Short URL portal (go.unlockos.io/{slug}) for guests
  • Location & contact settings (shown to guests on the booking page)
  • Search engine visibility, and a display of what SEO-relevant content is missing
  • Tax rate and calculation type settings
  • Business hours settings (by day, with holiday support)
  • Seasonal business hours for date classes (classes themselves are created on the "Special Dates" tab)
  • Team member management

Tabs

Tab Name Description
Facility Basic Settings Configure basic facility info and business hours
Special Dates Sales blocks and date classes (Settings → the "Special Dates" tab)
Team Invite and manage team members

Facility Basic Settings Tab

Facility Information

Field Description Required
Facility Name Display name of the facility Yes
App URL URL identifier (slug) used across all apps No
Facility Overview Overview description of the facility (text or URL) No
Terms of Use Facility terms of use (text or URL) No
Privacy Policy Facility privacy policy (text or URL) No

App URL (Facility Slug)

The slug is the URL identifier used across all apps (delivery, reservations, check-in, etc.).

URL format: xxx.unlockos.io/{slug}

Example: setting the slug to sakura-mansion makes the app URLs follow the pattern xxx.unlockos.io/sakura-mansion/.

Slug Rules

Condition Description
Allowed characters Lowercase letters (a-z), digits (0-9), hyphens (-)
Minimum length 3 characters
Format Must start and end with a lowercase letter or digit
Uniqueness Cannot duplicate another facility's slug

A real-time uniqueness check runs as you type.

  • Checkmark (✓): slug is available
  • Cross (✗): slug is already taken or the format is invalid

Slug and QR Codes

Once a slug is set, the registration QR codes shown on the Delivery Management "QR Codes" tab embed slug-based URLs (resident.unlockos.io/{slug}/register?room=...).

If you change the slug, any previously printed QR codes (using the old slug) will stop working. Always reprint and redistribute QR codes after changing the slug.

The slug is auto-generated when a facility is created. You can edit it later, but be aware that changing it invalidates existing QR codes.

App URL Preview Panel

Once you have entered a valid slug (3+ characters, no conflicts), a preview panel appears below the slug field showing all app URLs for your facility.

Entry URL format
Short URL (portal) go.unlockos.io/{slug}
Check-in checkin.unlockos.io/{slug}
Booking booking.unlockos.io/{slug}
Locker locker.unlockos.io/{slug}
Resident Registration resident.unlockos.io/{slug}/register
Front Desk frontdesk.unlockos.io/{slug}

Each URL has a copy button. Click it to copy the full HTTPS URL to your clipboard. A brief "Copied" confirmation appears after clicking.

The Short URL also displays a QR code (120 × 120 px). Guests can scan this QR code to reach the go.unlockos.io/{slug} portal page, which automatically lists or redirects to all available apps for the facility.

The preview panel is hidden while the slug is empty, fewer than 3 characters, or in a taken/invalid state.

Facility Information Field Input Modes

Each of the Facility Overview, Terms of Use, and Privacy Policy fields supports two input modes. Toggle between them using the radio buttons.

Input Mode Description
Text Input Enter content directly in a text area
URL Enter a URL to an external page (e.g. your website's terms page)

If no input mode is selected, the field is saved as empty. These values are displayed on guest-facing screens such as reservation confirmations and delivery (okihai) instructions.

Location & Contact

Field Description Required
Postal Code The facility's postal code No
Address The facility's address No
Phone Number The facility's phone number No
Contact Email The facility's contact email address No

All of these are optional, but when filled in they are shown to guests on the booking page as evidence the facility is real.

Search Engine Settings

Field Description Required
Official Website URL Your facility's official website (must start with https://) No
Show in Search Engines Whether the booking page appears in search results (ON by default) -
  • Official Website URL adds a link to your own site on the booking page, and tells search engines that this page belongs to your facility.
  • Show in Search Engines is ON by default. Turn it off and the booking page will no longer appear in search results (people who already have the URL can still book directly). Turn it off if you have your own website and want to avoid the booking page showing up alongside it in search results.

Content Gaps Needed for SEO Output

While Show in Search Engines is ON and at least one of the fields below is missing, a note reading "A few things would improve how this page looks in search" appears under this setting. It does not appear for facilities that have everything filled in, or for facilities that are not public.

Missing field How it degrades what search results look like
Address This has the biggest impact. Without an address, the page cannot output structured data that search engines recognize as a business with a map pin and phone number — it degrades to a weaker, generic organization format
Facility Overview Without a Facility Overview in Text input mode, the description shown in search results (meta description) falls back to a generic sentence shared across every facility, instead of something specific to yours
Phone Number Without a phone number, search results have no number to show, so there is no way for someone to call you directly from the results
Official Website URL Without it, search engines cannot be told how this booking page relates to your official site

An overview set to "URL" mode still counts as missing. If you chose "URL" under Facility Information Field Input Modes, that linked page is not text this page can read, so it is never used for the search description — this is the point that confuses owners who "added it, but it still says missing." Switch to "Text Input" and type the description directly if you want it to show up in search results.

The text is never auto-generated. This display only tells you what is missing — the actual wording and numbers for address, overview, phone, and website URL are always written by the facility owner.

Note that this list has no image item. The card image used when the page is shared on social media (og:image) is chosen from photos attached to rooms/plans, not from anything on this page, so it isn't something this screen controls.

Currency & Tax Settings

Field Description Required
Currency Selection Currency to use (JPY/USD/EUR) Yes
Timezone Facility timezone (used for pricing, day-of-week / holiday determination, and business hours) Yes
Tax Rate (%) Applicable tax rate Yes
Tax Calculation Type How to calculate tax Yes

Tax Calculation Type Options

Option Description
Exclusive Tax Add tax to pre-tax price
Inclusive Tax Tax included in displayed price
Non-taxable No tax

Holiday Settings

Field Description Required
Holiday Auto-detection Country Code Country for automatic holiday detection (JP/US/DE) No

This field does not control holiday rates on pricing plans. Holiday detection used by fee calculation (choosing the Holiday, Day Before Holiday and Weekend rates) reads the facility's "Country" setting in Facility Management. Facilities with no country configured never detect holidays, and a public holiday is billed as its ordinary day of the week. See Price Plan Settings for the day-type priority order and how to configure it.

Business Hours Settings

Field Description Required
24-Hour Operation Enable for no business hour restrictions No
Default Weekday Business Hours Business hours for Mon-Fri No
Default Weekend Business Hours Business hours for Sat-Sun No

Times use a 24-hour clock

Every time field is written on a 24-hour clock (00:00-23:45), so there is no AM/PM to misread.

Closing times additionally offer 24:00, meaning "through the end of the day". Both check-in and the hourly booking grid accept the whole day: the 23:00-24:00 slot is offered on the booking screen.

Bookings that cross midnight are a separate condition. They are enabled only when the day runs from 0:00 to 24:00 — the full day — which is also what 24-hour operation produces. A 5:00-24:00 day does not carry a booking into the next one.

0:00 is not offered as a closing time. When the closing time equals the opening time, the system reads the day as not trading at all. Picking 0:00 to mean "open until midnight" would make that weekday closed all day, blocking both check-in and bookings. 0:00 is withheld on the closing side for that reason, and 24:00 is offered instead.

Opening times still offer 0:00, since a facility may genuinely open at midnight.

To close a day, use "Closed" rather than 24:00. Setting the same time on both ends to express a closure is refused when you save.

Individual Day Settings

Click "Show Individual Day Settings" to set different hours for each day.

Field Description
Sun-Sat Business hours for each day (checkbox to enable)
Closed Close that weekday all day

Per-weekday settings win over the default weekday/weekend hours. At a facility where every weekday carries its own setting, editing the default fields above therefore changes nothing. In that state the default fields say "This field is not in use", and the individual day settings open expanded rather than collapsed.

If a change to the business hours does not take effect, check the individual day settings first for an override left behind.

Holiday Business Hours

Choose one of three ways holidays trade.

Option Behaviour
Follow the day of the week Holidays trade on whatever weekday they fall on (default)
Treat as a weekend Holidays trade on the default weekend hours, whatever weekday they fall on
Use different hours Enter an opening and closing time

Hours entered under "Use different hours" flow through to bookable times, whether check-in is allowed outside business hours, the charge and the auto check-out time, all at once. Holiday hours take priority over the individual day-of-week settings.

Which dates count as holidays comes from the facility country setting. At a facility with no country set no date is ever a holiday, so every option here behaves like "follow the day of the week".

To close on holidays, use "Closed" or a sales block rather than this field. Setting the same time on both ends to express a closure is refused when you save.

Special Date & Season Hours

Inside the Business Hours section. Each class you created on the Settings → "Special Dates" tab can carry its own business hours, or 24-hour operation, for that period only — "open until 22:00 through the summer", "24 hours during Obon" — without rewriting the settings by hand every season. New classes cannot be created here (that is the "Special Dates & Seasons" panel on the Special Dates tab).

Per-class hours take priority over the individual day-of-week settings and flow through to bookable hours, check-in outside business hours and the auto check-out time at the same time. See Seasonal Business Hours for how to configure them, the priority order and the effect on existing reservations.

Where a class is created and where its hours are saved are different. The class itself is created on the Special Dates tab, but its hours are saved with the save button in this Business Hours section (they write the same data as your regular business hours). The fields are being rolled out facility by facility, so they may not be visible yet.

Special Dates & Seasons (moved to the "Special Dates" tab)

Creating facility-defined date classes — high season, Obon week, New Year's Eve — and charging a different rate during those periods has moved to Settings → the "Special Dates" tab. It used to sit directly below this Business Hours section; create and edit classes there now.

Each class still appears in every price plan as a rate tab (a per-minute rate row on the Hourly Billing Plan) and takes priority over holidays, weekends and days of the week. See Special Dates & Seasons for the fields, the limitations, and the effect on existing reservations.

The Special Dates tab also has Sales Blocks (Sales Blocks) above Special Dates & Seasons. Special Dates & Seasons decides "what to charge on this date"; Sales Blocks decides "whether to sell this date at all".

Outside Business Hours Policy

Field Description Required
Outside Business Hours Policy Whether to allow check-ins outside business hours Yes

Policy Options

Option Description
Allow Check-ins allowed outside business hours
Deny Check-ins blocked outside business hours

Key Grace Period

Shifts when the lock starts accepting the key earlier, for guests who arrive before their reservation time.

Field Description Required
Activate the key before check-in How many minutes before the reservation starts the lock responds No (default: None)

Options

Option Behavior
None The lock responds from exactly the reservation start time (default)
1 / 3 / 5 / 10 / 15 / 30 min before The lock responds that many minutes earlier

What changes and what does not
Changes Only when the lock starts accepting the key
Unchanged When check-in opens (24 hours before the reservation starts; unrelated to this setting)
Unchanged Pricing. The grace period is free
Unchanged Room inventory. The grace period does not hold the room
Unchanged After the reservation ends. A grace period after checkout cannot be configured yet

Note

If there is no gap between reservations, the key overlaps with the previous or next guest for that time. The system does not look at adjacent reservations and shorten the grace period automatically. Leave this set to "None" if overlapping is a problem for your operation.

Team Tab

Member Invitation

Field Description Required
Email Address Email address of member to invite Yes
Role Permission level to grant Yes

Permission Levels

Role Description
Owner All operations allowed (including settings, member management)
Manager Can manage daily operations
Staff Basic operations like check-in
Viewer View data only

Invitation List

Field Description
Status Pending/Accepted/Cancelled/Expired
Invited At Date and time invitation was sent
Expires At Expiration date of invitation link

Buttons

Button Description
Save Save settings
Send Invite Send invitation email to entered address
Cancel Cancel the invitation
Delete Remove member from facility

Rooms & Locks Tab

Lock Assignment

The Lock Assignment section inside the "Rooms & Locks" tab lets you associate a KEYVOX lock device with each room (or locker).

Key Features

  • One lock can be shared across multiple rooms. For example, a coworking space can assign a single front-door KEYVOX unit to all booth rooms simultaneously.
  • Each room row has one dropdown. Selecting the same KEYVOX device on multiple rows saves correctly — the previous last-write-wins bug has been fixed.
  • Changing a room's lock immediately triggers a refresh so all other rows reflect the latest assignments.

How to Use

  1. Go to Basic Settings and click the Rooms & Locks tab.
  2. Select the Lock Assignment sub-tab.
  3. For each room row, click the dropdown in the "Lock" column and choose the KEYVOX device to assign.
  4. The assignment saves immediately and the status badge switches to "Assigned".

Note: Devices classified as "Entrance" do not appear in the dropdown. Assign entrance devices in the Entrance sub-tab.

Troubleshooting

Symptom What to check
No locks appear in the dropdown Connect your KEYVOX devices first under "Lock Connection"
Status badge does not change after selection The dropdown is temporarily disabled while saving. It refreshes automatically once complete
Cannot assign the same lock to two or more rooms This is now fully supported. Make sure you are on the latest version

FAQ

Q: Does changing the tax rate affect existing plans?

A: Yes, the tax rate in Basic Settings applies to pricing calculations for all plans.

Q: What happens when Outside Business Hours Policy is set to "Deny"?

A: Attempting to check in outside business hours will display an error message and block the check-in.

Q: Can I change a team member's permissions later?

A: Currently, you cannot change permissions once invited. Please re-invite with the new permissions.

Q: How long is the invitation email valid?

A: Invitation links are valid for 7 days. Please re-invite if expired.

Q: What happens if I don't set the App URL?

A: Without a slug, QR codes cannot be generated on the Delivery Management "QR Codes" tab. A slug is required to use the resident delivery service.

Q: What happens to existing residents if I change the slug?

A: Changing the slug invalidates all previously issued QR codes and registration URLs. After changing, reprint and redistribute QR codes from the "QR Codes" tab. Residents who have already registered can continue using the app, but will need to access it via the new URL when logging in again.

Q: What if I type characters that aren't allowed in the slug?

A: The input field automatically converts uppercase letters to lowercase and removes any characters other than lowercase letters, digits, and hyphens.

Q: "This URL is already in use" appears

A: The slug you entered is used by another facility. Try a different value. A unique identifier derived from your building name works well (e.g. add a number like your-building-2).

Q: Can I assign the same KEYVOX lock to multiple rooms?

A: Yes. For example, you can assign a shared entrance lock to multiple booth rooms. Simply select the same device in each room's dropdown.

Q: No rooms appear in the Lock Assignment section

A: Create rooms first in the "Room List" sub-tab. Only rooms with "Active" status are shown.

Q: Where are the Facility Overview, Terms of Use, and Privacy Policy displayed?

A: They are shown on guest-facing screens such as reservation confirmation pages and delivery (okihai) instruction screens. Use URL mode if you already have a policy page on your website, or Text Input mode to enter content directly.

Q: Can I switch between text and URL input modes at any time?

A: Yes, you can switch using the radio buttons at any time. Note that switching input modes will not preserve previously entered content, so save before switching if needed.

Q: What does the "A few things would improve how this page looks in search" note check?

A: It only applies to facilities where Show in Search Engines is ON, and it lists whichever of these four fields are empty: address, Facility Overview (in Text mode), phone number, and Official Website URL. The note disappears automatically once all four are filled in. Address matters most, since it decides whether the page can output structured data for search engines at all. None of the wording is generated for you — you always write the content for each field yourself.

Q: I filled in the Facility Overview, but it still says "Facility Overview" is missing

A: Check whether the Facility Overview field is set to "URL" mode. When it is, the linked page is not used as the search description, so it still counts as missing. Switch it to "Text Input" and type the description directly.

Q: Can I set the social-media share card image on this page?

A: No. This page's content-gaps list has no image item. The share card image is chosen from photos attached to rooms/plans.

Q: What is the Short URL (go.unlockos.io)?

A: go.unlockos.io/{slug} is a portal page that lists all active apps for your facility in one place (Check-in, Booking, Locker, etc.). Share this single URL with guests and they will be directed to the correct app automatically. If only one app is active, the portal redirects there directly.

Q: Where can I find the Short URL QR code?

A: The QR code for go.unlockos.io/{slug} is displayed in the App URL Preview panel on this settings page, directly below the slug input field. You can print it and display it at your facility entrance.

Q: Do old URLs with facilityId or configId still work?

A: Yes. Existing URLs that include facilityId or configId as query parameters continue to work and automatically redirect to the new slug-based URLs. There is no need to immediately replace them.

Q: Why don't I see the App URL Preview panel?

A: The panel only appears when the slug is at least 3 characters long and passes the uniqueness check. Make sure the slug field shows the green checkmark (✓) before looking for the panel.

Q: Does the key grace period let guests check in earlier?

A: No. Check-in already opens 24 hours before the reservation starts. This setting only changes when the lock starts accepting the key. It exists to fix the "check-in succeeded but the door won't open" situation.

Q: Does the key grace period cost anything?

A: No, and it does not hold the room either. It is separate from "early check-in", which is paid and does hold the room.

Q: Can I set a grace period after checkout?

A: Not yet. Only the period before check-in can be configured.

Q: Can I set a number of minutes that is not in the dropdown?

A: The screen only offers the listed options. If a facility already has a different value, that value also appears in the dropdown, so it is never silently lost.

Q: Why don't I see the "Special Dates" tab?

A: The ui_settings_date_tab feature flag is off for your facility. It has to be enabled per facility, so ask support to turn it on. Once enabled, the "Special Dates" tab shows both Sales Blocks and Special Dates & Seasons. See Special Dates & Seasons for details.

Open the MarkdownPaste it into an AI assistant.

Ask about this article

AI answers from this article's content.