Assigning or Changing Keyboard Shortcuts

Since the macOS 13.0 Ventura upgrade, System Preferences are now called System Settings.

There may be certain menu items that you find yourself using a lot for which there is no keyboard shortcut, or for which you find the keyboard shortcut overly convoluted. Fortunately, the ability to change or assign keyboard shortcuts to menu items is built right into macOS itself, although it's easy to miss. So, if you would like to change the key combinations assigned to commands in the Scrivener and Scapple menus, or if you want to add a keyboard shortcut to a command that doesn't have one, here's how:

  1. From the Apple menu in the top left corner of your screen, choose System Settings....
  2. Navigate to the Keyboard section of System Settings and click the Keyboard Shortcuts... button (on older operating systems than 13.0, this will instead be a tab called "Shortcuts").
  3. Select App Shortcuts from the sidebar.
  4. Click on the + button, and select "Scrivener" or "Scapple" from the Application dropdown menu in the dialogue box.
  5. In the Menu Title text field, enter the exact name of the command you want to add. This should exactly match the name of the menu item in the software (capitalisation matters). For instance, if you wanted to add a keyboard shortcut to Scrivener's Edit ▸ Insert ▸ Image from File... menu item , you would type "Image from File..." in this text field (including the ellipses). If you wanted to change the keyboard shortcut for the Edit ▸ Paste and Match Style menu command, you would type "Paste and Match Style".
  6. Click in the Keyboard Shortcut text field and then hold down the combination of keys that you want for the new shortcut.
  7. Click Done (or Add on macOS 12.0 or older).

Repeat steps 4 through 7 for each keyboard shortcut you'd like to add, and then you can close System Settings when you're done. When you return to Scrivener or Scapple, the new keyboard shortcut should be up and running.


Shortcut Conflicts

Keyboard shortcuts on macOS work by scanning the menus from left-to-right looking for a menu command matching the shortcut pressed. If you find that the shortcut you assigned doesn't work, or does something unexpected, it may be that the keyboard shortcut you chose is already assigned to a different command. In that case, you can either pick a different shortcut, or you can locate the menu item with which it clashes and go through the above process again to assign a different shortcut to the clashing menu item. (If the shortcut still doesn't work, you should ensure that the shortcut you assigned isn't one reserved by the system.)

Some menu items change names depending on the context. For such items, you may need to assign the same keyboard shortcut for each of their possible names. For instance, the Add Link... item under the Edit menu can sometimes change its title to become Edit Link.... Therefore, to add a keyboard shortcut to that item that would work consistently, you would need to add the same shortcut twice, once for "Add Link..." and again for "Edit Link...".

Duplicate menu titles

Sometimes a menu title will be used more than once. This most often happens with titles that are created dynamically from your project information. A good example of this is the Navigate ▸ Collections ▸ Name Of Your Collection and Documents ▸ Add to Collection ▸ Name Of Your Collection menu commands in Scrivener. If you created a shortcut called "Name Of Your Collection" alone, this would be bound to the initial shortcut that shows the tab in your Binder, not the command that files the current document into that collection. To target a specific command, you also need to type in its menu hierarchy by inserting -> between each menu level (with no spaces around the arrow), thus: "Documents->Add to Collection->Name of Your Collection"