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.

Key Features

  • Facility name, currency, and timezone settings
  • App URL (facility slug) settings
  • Tax rate and calculation type settings
  • Business hours settings (by day, with holiday support)
  • Team member management

Tabs

Tab Name Description
Facility Basic Settings Configure basic facility info and business hours
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.

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.

Currency & Tax Settings

Field Description Required
Currency Selection Currency to use (JPY/USD/EUR) Yes
Timezone Facility timezone (used for pricing 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

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

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)

Holiday Business Hours

Field Description
Use Default Business Hours Check to apply default settings
Holiday Open Time Opening time on holidays
Holiday Close Time Closing time on holidays

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

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

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: 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.