Keyboard Shortcuts

WhenToMeet supports keyboard shortcuts to help you work faster and more efficiently. Whether you're navigating between pages, creating events, or managing your calendar, keyboard shortcuts let you accomplish tasks without reaching for the mouse.

The main features are:

Command Palette (Cmd+K / Ctrl+K) — quickly access all major functions with a universal search
Keyboard Shortcuts Help (?) — discover what shortcuts are available on the current page
Customization — personalize your shortcuts in Settings to match your workflow

Getting Started

Two Entry Points for Discovery

Command Palette — Universal action center

Mac: Cmd+K
Windows/Linux: Ctrl+K
Search for any action, page, or feature by name or keyword
Shows page-specific shortcuts alongside global actions

Keyboard Shortcuts Help — Page-aware reference

Shortcut: ? (Shift + /)
Opens a modal showing all available shortcuts for your current page
Organized into Global and Page Actions sections
Press ? anytime to see what's available

Command Palette

Opening the Command Palette

Mac: Press Cmd+K
Windows/Linux: Press Ctrl+K

The Command Palette is a searchable interface that gives you quick access to all major functions in WhenToMeet.

Using the Command Palette

Navigate: Use ↑ and ↓ arrow keys to move through results
Execute: Press Enter to run the selected command
Close: Press Escape to close without executing
Search: Start typing to filter commands by name or keywords

What You'll Find in the Command Palette

The Command Palette organizes commands into logical groups:

Page Actions — Actions specific to your current page (edit, share, create, etc.) with their keyboard shortcuts displayed
Navigation — Jump to any page (Home, Events, Settings, Bookings, Groups)
Quick Actions — Common operations like Create New Event, Toggle Theme, Refresh Page
Help & Support — Access documentation, keyboard shortcuts, feedback, and more
Account — Sign in, My Account, Billing, Sign Out (based on authentication status)

Search Tips

The Command Palette understands natural language:

Type "create" to find "Create New Event" or "Create Group"
Type "edit" to find page-specific edit actions
Type "share" to find sharing actions
Type "help" to find help-related commands
Type "settings" to access your account settings

Page-Specific Shortcuts

WhenToMeet shortcuts adapt to the page you're viewing. When you press ? on any page, you'll see both Global shortcuts and the Page Actions available right there.

Default Shortcuts by Page

Page	Shortcut	Action
Global	`Cmd+K` / `Ctrl+K`	Open Command Palette
	`?`	Show Keyboard Shortcuts Help
Events List	`N`	Create new event
Event Detail	`E`	Edit event
	`S`	Share event
	`C`	Copy event link
	`Cmd+Shift+A` / `Ctrl+Shift+A`	Auto-fill availability from calendar
Event Editing	`Cmd+S` / `Ctrl+S`	Save changes
	`Escape`	Cancel editing
	`Cmd+Shift+A` / `Ctrl+Shift+A`	Auto-fill availability from calendar
Event Creation	`Cmd+Enter` / `Ctrl+Enter`	Create event
	`Cmd+Shift+A` / `Ctrl+Shift+A`	Auto-fill availability from calendar
Groups List	`N`	Create new group
Group Detail	`I`	Invite members
Bookings	`N`	Create booking page
	`A`	Edit availability

How Shortcuts Work

Smart Context Awareness:

Single-key shortcuts (like E, N, S) only activate when you're NOT typing in a text field, preventing accidental triggers
Modifier shortcuts (like Cmd+S, Cmd+K) work everywhere, even when focused on text inputs — matching browser and application conventions

Visual Discovery:

Look for keyboard icons and key hints next to buttons throughout the interface
The Command Palette displays shortcuts next to page actions for quick reference
Hover over the floating keyboard shortcut indicator on list pages to see available actions
Press ? to see a modal with all shortcuts for your current page

Customizing Your Shortcuts

Where to Customize

Go to Settings in the top navigation
Click on the Shortcuts tab
Adjust your preferences

What You Can Do

Master Toggle:

Enable or disable all keyboard shortcuts with a single switch
When disabled, actions are still available via Command Palette and buttons
Useful if keyboard shortcuts interfere with screen readers or other tools

Customize Individual Shortcuts:

Click the pencil icon next to any shortcut you want to change
Press the key combination you'd like to use
The system will check for conflicts and confirm the change
Your custom binding is saved immediately

Disable Individual Shortcuts:

Click the × icon next to any shortcut to disable just that action
The action remains available in the Command Palette and interface buttons

Reset to Defaults:

Click "Reset All to Defaults" to restore all shortcuts to their original bindings
This clears any customizations you've made

Important Notes

Locked Shortcuts:

Cmd+K (Command Palette) and Cmd+S (Save) cannot be customized
These follow browser and OS conventions, and changing them would cause confusion
Locked shortcuts are marked with a lock icon

Conflict Detection:

If you try to set a shortcut that's already in use, you'll see a warning
The system prevents duplicate key bindings

Authentication Required:

Sign in to customize shortcuts
Unauthenticated users see the defaults but cannot make changes
Your customizations are saved to your account and sync across devices

Tips & Best Practices

Press ? frequently — as you navigate different pages, press ? to discover shortcuts available on that page
Start with one shortcut — customize the action you use most often first, then gradually add more
Use single-key shortcuts for speed — memorable one-key shortcuts like N for New and E for Edit help you work faster
Rely on Cmd+K for less common actions — you don't need to memorize every shortcut; the Command Palette is your safety net
Take advantage of modifier shortcuts — Cmd+S and Cmd+Enter work even while editing, making common tasks frictionless
Use the floating toolbar on list pages — hover over the keyboard icon in the bottom-right to see available shortcuts without opening the full help modal

Accessibility

All keyboard shortcuts work with screen readers and assistive technologies:

Full keyboard navigation support — navigate and execute all actions using only the keyboard
Proper ARIA labels and focus management — screen readers announce shortcuts and their descriptions
High contrast mode compatibility — keyboard hints are visible in high contrast mode
Master toggle for accessibility — disable shortcuts entirely if they conflict with assistive tools

Troubleshooting

Shortcuts Not Working

Check if shortcuts are enabled:

Go to Settings → Shortcuts tab
Verify the "Enable keyboard shortcuts" toggle is ON

Verify you're not in a text field:

Single-key shortcuts like E or N don't work when typing (intentional behavior to avoid accidental triggers)
Try using Cmd+K (works everywhere) to access the Command Palette instead
Or use your mouse to click the action you want

Try refreshing the page:

Sometimes shortcuts need a page reload to activate properly
Press F5 or Cmd+R to refresh

Shortcut Conflicts

Browser or OS shortcuts interfering:

Some browser extensions or OS-level shortcuts may override WhenToMeet shortcuts
Try customizing the conflicting shortcut in Settings → Shortcuts
Or temporarily disable the extension/OS shortcut

Command Palette not opening:

Make sure you're pressing the correct combination:
- Mac: Cmd+K (Command key + K)
- Windows/Linux: Ctrl+K (Control key + K)
Check if another application has intercepted the shortcut
Try accessing it via the interface button instead

Help modal not opening:

Press ? (Shift + /) on your keyboard
Make sure you're not typing in a text field
If ? is disabled, access help via Command Palette: Cmd+K → search "Keyboard Shortcuts" or "Help"

Customization Not Saving

Ensure you're signed in:

Customizations require authentication
Sign in to your WhenToMeet account

Check for browser issues:

Clear your browser cache and try again
Make sure cookies are enabled
Try a different browser if the problem persists

Getting Help

Quick reference: Press ? on any page to see shortcuts for that page
Full guide: Visit this page for detailed information
Feedback: Use the Command Palette (Cmd+K) and select "Share Feedback" to suggest new shortcuts or improvements
Support: Visit /contact for direct support

Advanced Tips for Power Users

Memorize Common Single-Key Shortcuts

These shortcuts are consistent across pages and are worth memorizing:

N — Create New (event, group, or booking page depending on context)
E — Edit (event or availability)
S — Share (event or navigate to sharing options)
C — Copy link
I — Invite members
A — Administrate or adjust (availability)

Develop a Workflow

For quick navigation: Use Cmd+K to jump between pages
For batch operations: Use keyboard shortcuts to create multiple items or edit frequently
For form work: Use Cmd+S to save and Escape to cancel without removing your hands from the keyboard

Discover Hidden Features

The Command Palette often contains actions you can't immediately see on the page. Browse through Command Palette results when you have time to learn about features you might not be using yet.

Pro tip: The keyboard shortcut system is designed for both casual users and power users. Start with Cmd+K and ?, then gradually customize shortcuts that match your workflow.