Kiosk Name (Slug)

Set your unique kiosk identifier:

• URL Slug: This becomes part of your kiosk URL (e.g., "mystore" → kiosk.sortswift.com/mystore)
• No Spaces: Slug must not contain spaces - use hyphens or underscores
• Max Length: Limited to 64 characters
• Unique: Each store can have one kiosk name
• Can Change: You can update the slug anytime, but old URLs will break
• Best Practice: Use your store name or abbreviation (e.g., "mtg-shop-vancouver")

Kiosk Passcode

Configure the 6-digit PIN required to access your kiosk:

• Requirement: Must be exactly 6 numeric digits (e.g., "123456")
• Real-Time Validation: Shows checkmark when valid, error icon when invalid
• Security: Stored encrypted in database
• Change: Can update passcode anytime - takes effect immediately
• Best Practice: Use unique passcode, don't share with customers
• Reset Required: Users must re-enter PIN if passcode changes

Store Logo

Upload your store logo for branding:

• Upload Methods: Drag-and-drop or click to upload image file
• Formats: Supports all image formats (PNG, JPG, SVG, etc.)
• Processing: Logo converted to base64 and stored in database
• Display: Shows in top app bar, replacing store name
• Fallback: If no logo, displays formatted store name instead
• Removal: Delete button removes logo and reverts to name
• Size: Logo auto-scales to fit app bar height (recommended: square logo)

Display Settings

Additional display configuration options:

• Theme: Users can toggle light/dark theme (preference saved per browser)
• Responsive: Kiosk adapts to screen size automatically
• Fullscreen: Automatic fullscreen mode after PIN entry (configurable)
• Kiosk Lock: Prevents exiting fullscreen mode (see Advanced Features)

Saving Configuration

How to save your kiosk configuration:

1. Fill in kiosk name (slug), upload logo (optional), and set passcode
2. Ensure passcode validation shows checkmark (6 digits)
3. Click "Save Changes" button
4. Success message appears confirming save
5. Changes take effect immediately
6. Button disabled if no changes detected (dirty state tracking)

Access Methods

Multiple ways to access your kiosk:

• From SortSwift: Navigate to /integrations/kiosk - redirects to your kiosk URL
• Direct URL: Go to https://kiosk.sortswift.com/[your-kiosk-name]
• PIN Required: Must enter 6-digit passcode to access
• Verified State: PIN verification persists in browser (localStorage)
• New Device: Must re-enter PIN on new browser/device

Kiosk URL Structure

Understanding the kiosk URL format:

• Base URL: https://kiosk.sortswift.com
• Store Slug: /[your-kiosk-name] - your configured kiosk name
• Cart Route: /[store-name]/cart - cart page
• Store Landing: /select-store - store selection (if multiple stores)
• Example: https://kiosk.sortswift.com/mystore

Default Redirect Behavior

When accessing /integrations/kiosk from SortSwift:

1. System fetches your kiosk configuration
2. Extracts your kiosk name (slug)
3. Redirects to https://kiosk.sortswift.com/[your-kiosk-name]
4. If no kiosk configured, redirects to kiosk.sortswift.com (store selection)
5. Redirect happens automatically - no manual URL entry needed