(mac registration advice)

For best results, you should download the latest copy of Scrivener 2.9 from the [legacy downloads page], and use the following instructions. If you have already registered Scrivener 2.9 with your new 3.0 serial number, then you may skip these instructions; likewise if you are running into no issues with activation when launching either version, you may have no need of the following procedure. This is only necessary if you are continually running into activation issues, as both versions do share ...

The Default Button Set

We've curated a selection of buttons out of the box for quick access to commonly used functions, and a few tools suited to this prominent placement in the window. We'll go over these buttons in brief, pointing you to additional reading material if you are curious to read more on the feature itself. You aren't stuck with any of our choices, any of the buttons can be removed and there is a wide selection of alternative buttons available to be added. NOTE// add the following once the section exists...

(see also)

• [The Binder & its Outline].

• [Project Navigation].

• [Using Collections].

• [Project Search].

(see also)

• [View Modes]: the editor is also host to "group views", like the corkboard. Visit this topic for further information on the various group and text view modes available and how to make use of them.

• [The Editor & its Views]: the editor itself, as one of the central components of the project window, is discussed in-depth in this chapter, along with everything you need to know about the corkboard, outliner, splits and copyholders.

• [Writing and Editing]: if you're mainly looking for help on ...

Format Bar

Discusses the various tools available in the Format Bar, and provides cross-links to more thorough sections on various text editing features.

Copyholders

In addition to the two main splits, you can also pin a document to either (or both, for a total of four panes) of the editor splits in what we call a "copyholder"; like the thing you'd clip to the side of your computer monitor. Copyholders are not full split editors, and are thus only capable of display the media itself or the text content of an item---as depicted in [](#overview-editor). Want to check it out quickly?

MISSING_IMAGE:/path/to/gfx/copyholder-control_buttons.jpg

The copyholder head...

!Composition Mode

Introductory statement.

Full Screen Mode

Main article on Lion Full screen mode

Global Buttons

Adding or removing these buttons from *any* context will impact all contexts collectively.

MISSING_IMAGE:/path/to/gfx/touch_bar-global_buttons-w.jpg

Global buttons: Layout, Project Search and Add.

• Layout: quick access to toggling the visibility of the binder, collection list and inspector. This feature also has a three-way control for changing how the editor [views should be split](#touch_bar-layout-w).

• Project Search: moves the cursor to the project search field above the binder, or if ...

Binder Sidebar

The binder, along with the other various views that can occupy the left sidebar, have a few special buttons available. The binder button set itself cannot be customised, though additional global buttons can be added while using this context.

MISSING_IMAGE:/path/to/gfx/touch_bar-binder-w.jpg

Binder: Collections, Labels, Status and Search Result Sorting.

• Collections: quickly select between the different available binder views. By default this will consist of the binder itself and the most rec...

Corkboard Buttons

This bar also has the Icon, Labels and Status buttons available to it.

MISSING_IMAGE:/path/to/gfx/touch_bar-corkboard-w.jpg

Corkboard: Selection Affects, Open, Corkboard Layout

• Selection Affects: causes the active selection in this group view to be automatically opened in the opposing split view or attached copyholder (just like how the binder works). If you have both a copyholder and a split view then this button will rotate between targeting the two options and no auto-load. Refer to [Lin...

Outliner Buttons

This bar also has the Icon, Labels and Status buttons from the binder view, as well as the Open and Select Affects buttons from the corkboard view, above.

The outliner bar otherwise only contains one unique button, the Hide|Show Synopsis toggle. This button correlates with the option found in the footer bar of the outliner and simply toggles whether or not synopses [will be displayed beneath the title line][Special Columns].

Text Editing Buttons

As you might expect, the text editing areas of Scrivener are where most of the Touch Bar buttons dwell. Additionally, you will be provided with five separately configurable bars for different areas of the software:

1. Document notes in the inspector.

2. Comments and footnotes in the inspector.

3. When editing the contents of a table in the main editors.

4. Editing rich text in the scratchpad.

5. And finally of course the main text content itself, which can be accessed through the main edit...

Table Editing Buttons

When the cursor is within a table in the editor, the Touch Bar takes on a discrete context from the text editor itself, with table adjustment tools and a few editing buttons by default. This bar can be customised separately from the editor touch bar to hold any of the buttons from the editor that you desire.

In addition to the Table button itself (described before), there are [two provided buttons](#touch_bar-editor-table_buttons-w) for modifying tables:

MISSING_IMAGE:/path/to/gfx/touch_bar-ed...

Inspector Buttons

The last major area of the interface to cover is the inspector (which also pertains to the inspector split in quick reference panels, and the floating inspector in composition mode). Just as the inspector does more than a few tricks, its Touch Bar support varies depending on what you are doing within it.

With the exception of the few text editing areas, touch bar buttons in the inspector are not directly customisable, but you can still access customisation to manage the [global button set][Glob...

Compile Related Buttons

Lastly, the compile window has a few buttons to help you manage your compile settings more easily.

• Assign Section Layouts: corresponds to the button along the bottom of the layout preview area. Use this to change the look and feel of your document when it compiles.

• Close: simply closes the compile window without saving any of your settings.

• Reset: use this if you don't like where things have gone in this session, and wish to restore your settings to how they were when you first opened ...

Finding and Managing Projects as Files

Finally, as with managing projects that have been saved, you can also use the Dock, Finder, Spotlight, or other system tools to open files stored on your drive. In Finder, double-click the project you wish to open. Spotlight is also handy when a project gets misplaced and you are unsure of where it is saved.

If you don't recall the name of the project or where you saved it, you can search for "kind:Scrivener Project" to find every Scrivener project in your Spotlight index. If you're using the d...

Finding and Managing Projects as Files

Projects can also be opened directly using Windows Explorer, or any shortcuts to the project file that you have saved in your quick launch bar or desktop.

1. To open an existing project from your disk, you will first need to find the main project folder, which will be an ordinary folder with ".scriv" on the end of the name.

For example, if you named your project "Short Stories" in the My Documents folder, then you would expect to find a folder named "Short Stories.scriv" in My Documents.

2. ...

Splitting Projects Up

Brief advice on how to fork a project where one bit of it has outgrown the parent project.

Working Cross-Platform

Tips for working with Windows; what the project file looks like on both systems; and what to copy when transferring data from one computer to another.

Sharing Projects Over the Internet

If you wish to share a project using the Internet, you might think to attach it as an email, or upload it to a file sharing service so that one can download it or save a copy to an online backup service. Given that a project is a folder of files the best way to send a project is as a single "document", and the easiest way to do that is to use zip files (or whatever archive format you prefer). This can also prove a reliable way of copying projects to some types of external storage, such as USB th...

Project Size Limitations

Since Scrivener was primarily written with the long-form author in mind, much effort has been put into making the project format as robust as possible. It can handle book-length manuscripts with ease, store large quantities of research material, and handle many thousands of individual components, even on a single corkboard. Scrivener has been tested against projects with millions of words in them; way beyond what it would normally have to face. So for ordinary usage, you will never need to worry...

Sandboxing and Authorised Folders

<$MASOnly> Sandboxing is a technology used by all software sold through Apple's Mac App Store. Sandboxing works by limiting the tasks that applications are allowed to perform. One such limitation is that applications can only access files and directories that the user has granted access using an Open or Save panel.

For the most part you shouldn't notice this restriction. When you open a Scrivener project, in most cases all of the files it needs are contained within that project file and by open...

Effective Use of Project Merge

The following procedure outlines best practices for the use of this feature. Deviating from this procedure should only be done with care:

1. Create a copy of the project using one of the above methods.

2. At this point is safe to work in either or both projects simultaneously. For the best results you will want to avoid editing the same precise binder items while the two copies are "forked".

3. Once you are ready to merge the projects, open the copy you consider to be the "master" copy, and ...

(see also)

• [Restoring from Backups]: when things don't go as planned, use these instructions to get back to a better starting point.

• [Copying Files and Folders Between Projects]: it might sometimes be best to only copy a few things rather than perform a full merge, or maybe you only need to restore a portions from a backup. These instructions can help with both cases.

• [Using Snapshots]: the project merge feature will take a snapshot of an item whenever the main text of it has been altered by the p...

Collaborating with the Import Project Feature

This capability could allow for a limited form of collaboration between two people. If you provide someone with a copy of your project and continue working on it, while they make revisions to the project on their own, you can later on merge their changes back into your project.

It is possible to limit what you send to a collaborator, and have the additions or changes they've made merged back into the full project later on. For example you can use the File//Save As... command to create their cop...

Template Placeholders

There are [several placeholders][Project Template Placeholders] that you can type into the editor that are especially useful if you intend to share the template with others. For example, if making a template for yourself, you could just write in your name and address on your manuscript submission cover-page. This wouldn't work so well if you wish to share the template, though, and in fact Scrivener will check your templates for stuff that looks like your personal information and warn you if you ...

Project Template Placeholders

NOTE//WINDOWS// However this information is populated in the future, it probably won't be from Contacts.app!

Placeholder

Description

<$template_firstName>

First name from Contacts.app

<$template_lastName>

Last name

<$template_fullName>

Combines the first and last name for you, ordering them according to system language preferences.

<$template_initial>

First letter of first name from Contacts.app

<$template_street>

Street address

<$template_city>

City

<$template_ZIP>

Postal code

<$template_stat...

Custom Categories

The project templates that you create, or acquire from others, can sort themselves into custom categories, which will appear in the template chooser sidebar along with the built-in categories (Fiction, Non-Fiction, and so forth). Categories are defined by the templates themselves, rather than being something you create first and then put templates into. This way, if you download a category from the Web, it can set up its own category for you.

If you are still using Scrivener 21, these categorie...

Set Selected Template as Default

Changes the default template selection to the template you currently have selected. Once set, the next time you call up this window it will highlight that template for you for quick access.

Hide Getting Started

Hides the "Getting Started" category at the top of the category list. The functions it provides can also be accessed from the Help menu at any timefrom within any open project, so it is safe to remove the category once you've familiarised yourself with the program. You can also reveal it again using this same option menu.

Import Templates...

If you have downloaded templates from the Web or copied your custom templates from another computer, use this feature to import the files into the template system automatically.

Export Selected Template...

Useful for sharing your templates on the Web, with other authors or for transferring templates to another working computer.

Edit Info...

If you want to modify how the template appears in the template chooser, such as its title, icon, category or whether or not it builds predetermined styles into the new projects created with it, use this command. Refer to [Revising Templates] for further information. Built-in templates cannot be modified.

(reveal in Finder | Windows Explorer)

Reveal in the FinderWindows Explorer

: Reveals the selected template on the disk, using your file manager. NOTE//WINDOWS// note sure what nomenclature Windows version will be using here.

Delete Selected Template

When a custom template is selected, you can use this menu item to remove it from your system. Built-in templates cannot be removed.

For those interested in managing these as files directly, rather than using the above commands, templates are stored in Scrivener's support folder (use the Scrivener//Reveal Support Folder in Finder menu command to get here easily), under the "ProjectTemplates" subfolder. Changes made to this folder will be reflected in the template chooser window after it has been closed and reopened.

The Many Ways to Add Things

Since making new documents is such a vital part of Scrivener we've provided numerous ways to go about doing so, from toolbar buttons, to keyboard shortcuts to simply pressing the !Return key. Let's go over the options:

Figuring Out Where Things Will Go

The most basic concept to be aware of is that Scrivener will create new items relative to your current selection in the active view (be it the binder, editor or its copyholder). For example if we select a file in the binder and add a new text file, the file will be created after the selected file. When the focus is in another area of the project window, the selected item in the active editor view will be used. For example, if you create a new item while typing in the Document Notes tab of the in...

Renaming Items

To rename an item you've created, double-click the title to toggle editing mode. You can also use EscF2 key to toggle editing mode on the selected item. You can click elsewhere to save the modified title, or use the !Return key to confirm your changes.

If a title is left blank, Scrivener takes a dynamic approach to how things are named. You can read more about titles in [Titles and Adaptive Naming].

Keyboard Navigation

The four arrow keys by themselves will move the selection around in the outline according to the following rules, and can be augmented with a few modifier keys:

• UpArrow and DownArrow move the selection up and down the list from one visible item to the next.

• LeftArrow will move the selection leftward in the hierarchy, selecting the parent of whatever was selected when pressing the key. The left key will also collapse the selection, if any of the selected items are expanded. If a group (or ...

With the Mouse

Selecting items with the pointer (whether it be controlled by mouse, trackpad, tablet or joystick) is a standard set of functions that are broadly useful in many applications. The rules are simple, but can be combined to produce selections of items that would be difficult or even impossible to produce with the keyboard.

• As noted above, simply clicking on an item will select it and simultaneously remove the previous selection, meaning you'll only ever have one item selected at a time when cli...

Moving with the mouse

Items can be moved around in the binder with drag and drop. Pick up the item by clicking and holding the mouse button down, then drag the mouse pointer to where you wish to drop the items, releasing the button. The binder will display a blue target underneath the pointer, showing where the drop will end up. Slide the mouse left or right to control the indent level of the drop point, and leave the mouse along the top or bottom edge of the view to dynamically scroll it.

If the place you want a dr...

Copying with the mouse

Although not enabled by default, you can toggle this capability with the "Option-dragging creates duplicates" option.

Another approach is to duplicate the files with the Documents//Duplicate submenu (<$custom:shortcut>), which will create a copy right alongside the original that you can drag and drop to the intended location.

Moving items with the keyboard

NOTE// If shortcuts for moving items ever change, you'll need to fix these hard-coded references. Ctrl-Cmd-ArrowCtrl-Arrow keys can be used to move an item around spatially in the binder, step by step. Up and down will increase or decrease its placement in the outline, while left and right will promote and demote the item. For example, selecting a folder that holds the contents of chapter eight, and pressing <$custom:shortcut> will move it down one spot, swapping its position with the chapter b...

With the Toolbar

Although not present in the default set of toolbar icons, you can add item movement buttons to the main toolbar, provided as either a four-way set of movement buttons, or two pairs of up/down and left/right buttons. These operate in a similar fashion to keyboard movement, one step at a time in the indicated direction.

By the icon

A bit of knowledge that can save you a lot of time is that everywhere you see an icon in Scrivener, you can drag it, and in doing so it will act as a proxy for that item, just as though you dragged it from the binder or any other view. You might be writing in a file in the editor and realise you want to move the section to a spot in the binder on your left. You could attempt to locate the item in the binder and then drag it from point A to B, but instead you can drag the icon straight out of the...

Moving Multiple Items

If you've selected multiple items, most methods for moving them will gather these items together at the target location, in the order they appeared in the selection (in most the binder order). There are some important exceptions:

• It's an extension of the above, but bears reiteration: if the view the you selected from has been sorted (such as in the search results sidebar or the outliner) then the moved items will be assembled in the target location using that sorted order. For example, if yo...

Long distance travel

When you need to move a file so far that the point of its destination is out of sight from the point of origin, sometimes neither the keyboard nor the mouse can be convenient all by themselves. To fill in that gap, we have two methods that should help:

1. The Documents//Move To submenu presents a list of all the items in your binder, each and every one of them a potential target for your drop. The item you select will become the parent for the moved item, and it will be places as the last sibl...

Copying Files and Folders Between Projects

The easiest way to copy a file from one project to another will be through the following steps:

1. Open both of the projects at once.

2. Drag the item icon from the binder, corkboard or outliner view, or anywhere where you can see its icon and it is draggable.

3. Drop the icon into the project you wish to copy the item to, into a location where files can be dropped.

If you drop into a text editor you'll get a link instead, if you drop into a bookmarks list you'll get a handy link---but if y...

By elements

We might as well get the basics out of the way first. To expand or collapse portions of the outline, click on the arrow (when using the classic Windows theme, this will be a "+" or "-" icon instead) to the left of any group to reveal or hide its contents. The *state* of every arrow in the binder will always be remembered, meaning you can expand or collapse areas within larger chunks of the tree, and then collapse the whole thing, assured than when you expand it again it will be as you left it. T...

Incrementally by level

Sometimes fully expanding a section of the tree will be more than you want, but you still wish to expand down two or more levels. This can be done by alternating between two different complementary commands:

1. Press RightArrow to expand the tree one level.

2. Use the Edit//Select//Select Subgroups menu command to move your selection from the main group to all of the items within it that are also groups.

3. You guessed it, RightArrow again to expand the second level. Repeat until the tree is...

Reveal and hide everything

The menu commands "Expand All" (<$custom:shortcut>) and "Collapse All" (<$custom:shortcut>) in the View//Outline submenu will expand or collapse every container in the view at once. Both of these commands work in many areas of the interface where it is possible to expand or collapse items.

Collapse all to current level

<$include>

Hoisting the Binder

Although not technically an operation that falls under managing the tree outline---where it comes to corralling an ever-growing corpus of information and writing material---being able to focus the binder on only one portion of the larger outliner deserves mention here. If the idea of blotting out everything in your binder save for the contents of one folder (like one chapter in the draft) appeals to you, hoisting is what you're looking for.

To hoist the binder, select one single container of an...

Marking Items as Separators

In longer outlines it might prove useful to add visual separators so that you can easily scroll between them, as landmarks in a large tree. This is done not by inserting a special separator item, but by marking existing items as being separators. The effect is to display this item's title in a bolder font and draw a shaded box around it. This is an item setting, and as such will be duplicated along with the item, or included as part of a [document template][Document Templates].

MISSING_IMAGE:/p...

Tips for Sharp Icons

After you add an icon to the manager, what you see in the window is what you will see in the binder and other views. If the icon looks distorted or blurry to you in this window, then it will look that way everywhere. You can remove a bad attempt and try again using the following tips for creating sharp and great looking icons:

• Common problems are files with lots of white or transparent padding around them. Open these files in a graphics editor (even PreviewMS Paint will do for simple croppin...

Creating High-Resolution Custom Icons

NOTE//WINDOWS// This has been opened up to both platforms as the new version of Scrivener for Windows will support hi-res. It will need to be verified if the specs are right, and if this method of importing icons works. If you intend for your icons to look good on both RetinaHi-Res and standard displays you will need to supply two different icons (16 px square for standard; 32px square (at 144 DPI) for high resolution). Importing a dual-purpose icon is simple:

• Name the low-resolution version...

Creating Your Own Icon Sets

How you name your custom icons will determine whether or not they are grouped together as a set in the custom icon menu (like the built-in "Flag" set). The format for this naming convention is "Category (Icon Name)", such as "Flag (Blue)". This causes this particular icon to be grouped together with the Flag set and displayed in the menu as "Blue".

Making Icons iOS Compatible

Naturally, icons that are installed on your computer will not appear on iOS if you take your project to that platform. However if you load your icons into the project, it will use them if it can.

The iOS version of Scrivener uses a different size icon than either macOS or Windows versions. This can mean that making an icon that looks crisp and clean between all platforms isn't viable, but a reasonable compromise can be made by using the larger 90 x 90 pixel size and letting each system downsize...

Icons from Other Sources

Renaming icons

You are not stuck with an icon name if you don't like it, but take the caution above to heart. If you have already used this icon for some time in your projects, all of those items referring to it will lose the assignment (unless you change the name back), as they will only ever be looking for the old file name on the disk.

1. Open the icon manager with Documents//Change Icon//Manage Custom Icons...

2. Double-click on the name of the icon you wish to rename.

Take care to not edit the extensi...

Removing icons from Scrivener

You can remove an icon from either the current project or globally from your computer. This will not strip the assignments to that icon from other projects, and so if you ever change your mind and add the icon back, you'll find all of those items go right back to working the way they used to.

1. Open the icon manager with Documents//Change Icon//Manage Custom Icons...

2. Select the icon(s) you wish to delete (Shift and CommandCtrl work here).

3. Click the respective DelButton button beneath ...

Copying Icons Between Global and Project

Icons can be dragged between the lower and upper sections individually, or *en masse*. Icons in the lower list will be available to all of your projects; past, present and future. Icons in the top list will only be visible to *that* project; however they can be duplicates of icons that are in the lower list. If you've created an icon for a project, and later decide you'd like to use it everywhere, you can simply drag and drop it into the lower table. If you try to drag an icon with an identical ...

Custom Icon Portability

The final thing to consider is whether or not icons will be visible off of your computer. If you've been adding icons to your computer, in the lower half of the pane, then when you take your project file to another computer all of those icons will not be displayed. They will still be assigned, but since Scrivener cannot locate any replacement icons, they will simply be ignored until you return to the original computer.

So when working on multiple computers, it is good idea to drag your global ...

Icons on the Disk

Scrivener merely checks a couple of locations for files when working with icons, meaning you can manage icons yourself directly with a file manager if you prefer to do so over the user interface in Scrivener. Global icons will be located in Scrivener's support folder, use the Scrivener//Reveal Support Folder in Finder menu command, and then double-click on the "Icons" folder.

For project-specific icons, they will be stored directly in the project itself. With the project closed, right-click on ...

Setting a Document Template Folder

Templates are designated by placing them into a special folder, marked as being a template folder. Each project can only have one template folder at a time. To set it up, you'll need a folder to start with, it can be empty or already contain a few items you wish to use as templates. This folder can be placed anywhere in the binder except for within the Draft and Trash folders. Once you've created the folder, you will need to designate it as being the official templates folder for this project:

...

Creating Document Templates

Creating new templates is as easy and no different than creating a normal file or folder item in the binder. There is nothing special about these items, save for their position within the designated templates folder. Anything that you add to the templates folder will be available for usage within the project.

Any type of file that you can add to the binder (which is just about everything) can become a template. For many types of files this wouldn't serve much purpose---who needs dozens of copie...

Creating New Items with Templates

Once a container is designated as a template folder, and items have been added to it, you can create copies of these files elsewhere in the project via the Project//New From Template submenu, or by using the green AddButton button in the toolbar. The items in this menu will be arranged precisely as they have been organised in the binder, with groups becoming further submenus. Creating new items from templates will follow all of the same rules and behaviours used to create built-in types like tex...

Clearing Document Template Folder

Use the following instructions to clear the document template folder:

1. Open project settings with the Project//Project Settings... menu command (<$custom:shortcut>).

2. Click on the Special Folders tab.

3. Using the dropdown menu in the Templates Folder section, select "No Templates Folder", at the very top of the menu.

4. Click the OK button.

This action will not delete anything in your project. It will merely remove the special status from the previously designated templates folder. It...

Cascading Default Templates

Each folder (or file group as the case may be) can have its own default type assignment. Where subgroups are concerned, the default type "cascades" into all subgroups, no matter how deeply nested. The exception to this is when a subgroup within that hierarchy has its own default template type assigned to it.

MISSING_IMAGE:/path/to/gfx/org-doctemplates-subdocument_types.jpg

A demonstration of multiple subdocument templates in action.

In the [provided illustration](#org-doctemplates-subdocument_...

In the Inspector

MISSING_IMAGE:/path/to/gfx/section_types-inspector.jpg

The inspector is a handy way to view and adjust the section types of individual items.

Click the [Metadata inspector tab][Metadata Tab].

Expand the "General Metadata" section if necessary.

Click the dropdown control to open the section type selection menu.

In the Outliner

As we have seen [previously](#project_settings-section_types-in_practice), the outliner view with the "Section Type" column added to it (use the View//Outliner Options//Section Type menu command if you don't see it) is a great way to get an overview of the type assignments for large groups of items. To change an assignment for an item, click into the section type cell for that item's row and make your selection from the menu.

With the Contextual Menu

When you need to change the section type assignment for many items at once, the right-click contextual menu is the way to do it:

1. Select the items you wish to change in any group view or in the binder sidebar.

2. Right-click on the selection, and use the "Section Type" submenu to change the type.

When you have a mixed selection, the "Default Subdocument Type" portion of the menu will never be shown. Keep your selections confined to containers of any type if you need access to it.

The Active Editor and Targeted Editor in Split Views

There are two concepts to be aware of when using splits:

• Targeting: the split that is targeted will have a blue background. This means anything you click in the binder sidebar will be loaded within that split; clicking "targets" that split.

• Active: this is the split you are working in, or where you have clicked into the editor last. In some cases that may not be the split that is targeted (by default the two conditions are one and the same). The active split is indicated by an underscore ...

History

On the left side of the header bar, marked (a) in [](#editor-header-buttons) are the history navigation buttons, which should be familiar in usage from any Web browser. Use these to navigate backward (<$custom:shortcut>) and forward (<$custom:shortcut>) through the navigation history.

If you right-click (or click and hold) on either of the arrow buttons, a menu will be provided, making it easy to jump straight to something far back or forward in the history without having to go through each poi...

Header Bar Icon

Proceeding left to right, after the navigation buttons you'll see an icon (between markers (a) and (b) in [](#editor-header-buttons)). This is not merely ornamental, the icon can be dragged and in doing so the action is identical to dragging the item from the binder. You can thus move a file you have open by dragging this icon to another folder in the binder or a corkboard in another split---and any other task that can be done with drag and drop in Scrivener.

For binder items that you are view...

Header Bar Contextual Menu

The main editor header bar itself can be right-clicked (anywhere except for the history buttons, which have their own right-click functions) to reveal a contextual menu with a number of commands from the main menus, but also some unique commands you won't find elsewhere. The following is a listing of all the commands that are available and their uses:

Header Bar Title

Continuing along our journey of the header bar, we arrive at the name of the thing being viewed itself, marked (b) in [](#editor-header-buttons). As you navigate through the project, the title here will update to reflect the current contents of the editor. In most simple cases, it will display the title of the document you are currently viewing or editing.

When viewing a group of items in a corkboard or outliner, the name of the viewed container will be displayed. For example, if you click on a...

Inspector Locked to Editor Indicator

The red button to the left under the (c) marker in [](#editor-header-buttons) will appear when the inspector has been locked to this editor split, and thus serves as a visual indicator of which split the inspector is making use of. You can click the button to dismiss the lock.

Jump to Scrivening or Corkboard

The button on the right side, marked above (c), will only appear under two distinct conditions:

• If the editor is displaying a [Scrivenings session][Editing Multiple Documents], this is the "Jump to Scrivening" button. One entry for each chunk of text (or "scrivening") will be displayed, offering quick navigation within a section, or mere reference of where you are within the overall session.

• When viewing a [stack of corkboards][Stacked Corkboards] the tool will generate a list of every co...

Sidebar Navigation

Next, you will find two chevron style arrows pointing up and down, under the (d) marker in [](#editor-header-buttons). These arrows provide sequential navigation within the project sidebar (be it the binder, search results or collection list).

Clicking the up arrow (or using the <$custom:shortcut> shortcut) will move you to the document immediately above the current document in the sidebar. The selected document will always be the one immediately above, even if that item is currently hidden and...

Split View Button

The last button on our tour, marked (e) in [](#editor-header-buttons), is a multi-purpose button for controlling editor splits. What will happen when you click on it will change depending upon the current layout of the application and your last preferred split orientation.

MISSING_IMAGE:/path/to/gfx/editor-header-split_buttons.jpg

The three split button states: split horizontal, vertical and close split.

The function of the buttons as shown in [](#editor-header-split_buttons) are:

1. Change ...

Group View Controls

MISSING_IMAGE:/path/to/gfx/editor-corkboard_outliner_footer.jpg

The footer bar controls for outliner and corkboard.

Both the corkboard and outliner will feature the same cluster of controls on the [left side of the footer bar](#editor-corkboard_outliner_footer):

• The AddButton button creates a new text item---the same as would do when using any of the other methods for doing so, such as <$custom:shortcut> or Project//New Text.

• As well, the next button creates a new folder in the same fash...

Text Zoom

You can make the text in the main editor larger or smaller without changing the font by using the text scaling pop-up in the left side of the footer bar. See [Scaling Text] for more information.

Quick Text Statistics

In the middle of the footer, the word count of the text you are editing will be displayed in real-time as you type. This counter works for all visible text, even if it would otherwise not be compiled, and will aggregate all text together when using Scrivenings view. This counter will also display the statistics for the current *text selection* if one exists. When the counter is displaying selected text, the colour will turn blue to indicate that it is no longer counting the entire document(s) te...

Text Goals

When you are editing a single document in standard (not scriptwriting) mode, a small target icon will appear on the [right side of the footer bar](#editor-text_footer_bar). This button brings up the target options for the current document where will let you set the numeric word or character goal you intend to achieve with the section. Refer to [Document Goals] for further documentation on this feature.

Included in Compile Indicator

The last element on the footer bar, which appears in text editing mode for all text and group items in the binder, is an indication of whether or not the active document will be included in compile. If the document has a small checkmark in the corner then (unless other conditions exclude it, such as selecting a different chapter as a target) it will be included in the output. A small "X" icon means this document will never be included.

MISSING_IMAGE:/path/to/gfx/editor-footerbar-include_in_comp...

Viewing Images

The image viewer is displayed in the main editor area whenever an image document is selected or opened. The current magnification of the image will be displayed in the footer bar of the editor, along with the customary controls for external editing and refreshing.

Viewing PDFs

The main editor serves as a basic PDF viewer, suitable for referencing works while you write.

MISSING_IMAGE:/path/to/gfx/editor-footerbar-pdf_controls.jpg

Editor footer bar displaying PDF controls.

The PDF view is displayed when a PDF document is selected. You can control the display of the PDF document via the controls provided at the bottom of the editor, in the footer bar, and with the contextual menu.

• Use the page selector on the left to skip from one page to the next with the arrow bu...

Viewing Multimedia Documents

The QuickTimemultimedia view is used to display movie and sound files. From the control interface (which will appear when the mouse is moved within the viewing area) you can play or pause the movie, change the volume, or step backwards and forwards through it.

There are further tools to further aid transcription:

• You can use the <$custom:shortcut> shortcut key to pause and resume a media stream, even while you are typing in the other editor, never having to leave the keyboard.

• You may s...

Viewing Web Pages

The web view displays archived web pages, which will in most cases be a preserved copy of the page at the time it was imported. Even if the page changes live, or is subsequently removed, your copy will be safely stored. Some pages do not follow Web development standards as well as others, and you may find they do not archive properly or at all, resulting in missing content after a while, or even blank and malfunctioning pages shortly after archival. There is unfortunately nothing we can do about...

Viewing Unsupported Document Types

Scrivener will let you import files into the Binder that it cannot display in the editor. Unsupported file types will use any Quick Look preview provided by Finder, or the default system icon if available.

MISSING_IMAGE:/path/to/gfx/editor-footerbar-research_files.jpg

The footer bar when viewing media: Quick Look, Open in External Editor and Reload.

To view the file in its default viewer:

• Double-click the icon to load the file in the default external editor for that file type.

• Click the...

Reloading Edited Research

When viewing most forms of media the editor will feature [a "refresh" icon on the far right of the footer bar](#editor-footerbar-research_files). Clicking this button will reload the file off of the disk; something you will need to do when editing the file externally. This works for files that have been imported fully into the project as well as those that have been linked from the disk using an aliasshortcut.

Documents are refreshed automatically whenever you navigate to them in the editor (ev...

Horizontal and Vertical Splits

MISSING_IMAGE:/path/to/gfx/editor-splitting_views.jpg

The editor can be split vertically (left) and horizontally (right).

The editor interface can be split in one of two orientations. In vertical mode, the divider will be drawn down the middle of the screen, and is most suitable to viewing two text documents side-by-side as it maximises vertical space. Horizontal mode creates a split with content on the top and bottom. In either case, both sides of the split have the same degree of power in loa...

Managing Split Views

If you wish to swap the actual position of the material in the editors, so that the content on the left now appears on the right, for example, use the View//Editor Layout//Swap Editors menu command. This swaps *everything* about the editors, including history queue, view modes, display settings and so forth.

To clone the contents of both splits, right-click the document icon in the header bar for the side you wish to clone, and select the "Match Split Document" command. This will duplicate your...

Controlling the Opposing Split

There are a few commands that you can use to impact the editor your are not currently working in, reducing the need to flip back and forth between them. These are located in the Navigate//Editor//Other Editor// submenu, and have shortcuts for handy usage:

• *Remote history access*: Just as you can quickly flip through the history with <$custom:shortcut> and <$custom:shortcut>, you can cause the other editor the jump back and forth in its own history queue with <$custom:shortcut> and <$custom:s...

Loading an Item in a Copyholder

There are a few different ways to load an item into a copyholder:

• Using the Navigate//Open//in Copyholder menu command. This command is also available as a contextual menu item from an editor's outliner or corkboard views.

1. Select the item you wish to load in any binder, corkboard or outliner view.

2. Use the menu command to load the copyholder into the active split (the one with a blue underline beneath its header bar).

• Click to drag an item's icon, and while dragging hold down the O...

Creating an Item from a Copyholder

If a new text or folder item is created while the focus is within a copyholder, the item will be created relative to the binder position of the item the copyholder is viewing, not the main editor. This will always be done in accordance with [the normal rules for placing new items][Figuring Out Where Things Will Go].

Changing the Orientation

To adjust a copyholder's position, use the View//Editor Layout//Copyholder Position// submenu, or simply right-click on the copyholder's header bar, selecting one of:

• Left

• Right

• Top

• Bottom

Your choices will be necessarily limited if the editors are split. For example if the editors are split vertically, you would only be able to position a copyholder on the top or bottom of current the editor. This also means that a copyholder might change its orientation automatically to make spac...

Changing a Copyholder's Content

Although a copyholder pane will resist automatically changing its content based on navigation commands made to the editor, you can of course manually change what you are working on. The copyholder header bar is a valid target for dropping item icons to.

Once you have started viewing different things within the pane, the standard history keyboard shortcuts (<$custom:shortcut> and <$custom:shortcut>) can be used to flip between recently viewed items.

If the document in the main editor has other ...

Detaching a Copyholder to a Window

To detach a copyholder and convert it to a Quick Reference panel, click the second icon from the right in its header bar. This is a great way to free up space in the main project window without losing access to the content you are working with.

To do the inverse, embed a Quick Reference window into an editor split as a copyholder, there is no one-click trick for doing so, but you can drag the icon from the Quick Ref's header bar into an editor split with the OptionAlt key held down, and then cl...

Closing a Copyholder and Reopening Content

When you are finished with a copyholder and its content, click the CloseButton button in the right-hand corner of pane. Closing a copyholder in this way will add the item you were viewing to an internal list of recently viewed items within the current editing session.

If at a later point in time you would like to view the content again, you needn't hunt it down. Open the copyholder pane again using whatever is most convenient (you can simply OptionAlt-drag a header bar's icon onto itself for in...

Linking Copyholder Content to a Split

MISSING_IMAGE:/path/to/gfx/copyholders-autoload_from_split.jpg

The corkboard in this editor has been linked to the copyholder above it. Cards selected in the corkboard are automatically loaded in the copyholder.

In addition to providing a semi-static reference while you work in the primary split, the copyholder feature can also be used to automatically display the content you have selected in its primary editor. You can think of this as being a bit like the relationship between the binder and a...

Snap to Grid

Do you like how you can move cards around freely in freeform mode, but wish you could keep things lined up a little neater? The View//Corkboard Options//Snap to Grid menu toggle might suit you. This setting impacts all freeform corkboards in the project. There are a few things to be aware of:

• Cards will not be snapped to a grid until you move them yourself.

• If you select several cards at once, only the card that your mouse was over when you start the drag will be snapped to the grid. The ...

Commit Order

If you reach a point where you would like to make the ordering of cards permanent in the binder, you can choose to commit the freeform order back to outline order. Click the Commit Order button in the footer bar, or use the View//Corkboard Options//Commit Freeform Order menu command.

You will be given a few options to define your ordering style. Some work left to right, others right to left or top down; this panel will let you apply the ordering no matter which way you work. Once you click the ...

How Cards are Display in Label View

There are two axes used to display cards:

Across the tracks

: When viewing label tracks in horizontal orientation, such as in [](#corkboard-arrange_by_label-simple), the *columns* represent the position of items within the folder. Column 1 is the first card in the folder, "Contents" in this case, which does not have a label assignment. Column 2 is a card assigned to the first label thread and is the second card in the folder.

: Therefore, you can only have one card per column---having more tha...

Moving Cards Across and Along Label Threads

Just as with the other corkboard views, you can freely drag and drop cards among the other cards. As with linear view, movement can directly impact the order of the cards among their group, so long as movement is done on a tangent to the label tracks themselves.

Referring again to [our example corkboard](#corkboard-arrange_by_label-simple), if we selected the card in the second column (the one marked "Done") and dragged it to the right of the card in the fourth column---or the second card on it...

Creating Cards on a Thread

When the Double-clicking corkboard background option is set to "Creates new card", in [the Behaviors: Double-Clicking !preference tab][behaviours - double-clicking], you can double-click directly on a track to create a new card automatically assigned to that label in the position you double-click on, pushing the stack of cards to the right (or down when using vertical orientation) to make space for it in the place where you double-clicked.

Card Size

There are two ways of arranging index cards within a corkboard. The first is to set the size of cards and then let the corkboard wrap the cards as they fit, the second is to provide a number of cards you always want to see in each row, and let the corkboard resize the cards to fit that number. When the latter method is in use (see below, for setting that), the Size control will be disabled.

In the freeform and label modes, only the card size method applies as there is no automatic wrapping or f...

Ratio

Determines the size ratio between height and width. By default this will be 3 x 5, in order to emulate the appearance of real index cards. If you write very long or very short synopses however, you might find that adjusting this to produce shorter or taller cards will be of benefit.

Spacing

This option is not relevant to the freeform corkboard mode.

The amount of space that will be drawn between index cards, both vertically and horizontally. To pack more cards into the display at once, move the slider toward the left. To spread out the cards and make them more distinct, move the slider to the right.

Cards Across

This option is only relevant to standard corkboards.

Set this to the number of cards you would like to appear in each row. Use "Auto" to have Scrivener determine this amount based on the size of the cards. When Size to fit editor is disabled, it is possible for corkboards to grow larger than the editor size, which may be desired for some purposes, and will require horizontal scrolling in order to see the entire corkboard contents. You can choose any number between 1 and 10 cards across, or use ...

Keyword chips

Set the maximum number of keyword colours to be "taped" to the right side of the index card. When a document has more than that amount assigned to it, all keywords below the specified point will be ignored. You may wish to adjust the Ratio to increase the height of the index card, if you want to view large numbers of keyword chips at once. You will need View//Corkboard Options//Show Keyword Colors enabled to see the effects of this.

Size to fit editor

This option is only relevant to standard corkboards, and is not available if Cards Across is set to "Auto".

When the Cards Across option is set to a number, this option will resize the cards to fit the current editor width. With this option off, the card size option will be used, and cards will be forced to wrap at the specified number regardless of the window size.

That's not all!

There are a number of other appearance related preferences that you can set, which can dramatically alter the look and feel of the corkboard and its index cards. Most of these options are located in [the Appearance: Corkboard][Appearance - Corkboard] and [Appearance: Index Cards][appearance - index cards] !preference panes.

If you enable the Allow drop ons in corkboard setting in [the Behaviors: Dragging & Dropping !preference pane][behaviours - drag and drop]---you'll also be a...

Word Processing Files with Stylesheets

Used by files with .docx, doc, .rtf and .odt file extensions.

Word processing documents that use a stylesheet to establish a heading outline (such as "Heading 1", "Heading 2" and so forth) can be imported into the project as a structured outline. Each heading will generate a new document in the binder, named by the text of that heading, and nested according to its stylesheet outline depth. All text following the heading, up until the next, will be inserted into that item's main text content.

I...

Split by Separator

Used by all standard text document extensions, except for scriptwriting documents. This includes word processing and Markdown files, which can use this alternate behaviour instead of stylesheet/heading splitting by enabling the Split into sections by finding separators in the text option.

Type in the separator that was used in the text to define sections. A common example might be a "#" character, used to break scenes in a standard manuscript. Any line in the document that begins with the text ...

Markdown Files

Used by files with .markdown, .md, .mmd and .txt file extensions.

In similar theory to the use of a stylesheet in a word processing file, Markdown headings describe a document structure that can be recreated in the binder. If a MultiMarkdown or YAML metadata block is found, it will be inserted as the first document at the top level. When exporting, the Compiler can use this file to merge metadata found in the draft folder with any fields supplied in compile settings. Below that, each header fo...

Final Draft and Fountain

Used by files with .fdx and .fountain file extensions.

When Final Draft files are imported using this tool the file chooser options will provide a selection of elements to choose from. You can select any one element to split by. The imported script file will be split into multiple binder items at the requested break points, in addition to splitting at any scene headings (select "Scene Headings" to only break on those). Scene summaries will be imported into synopses and scene titles will replace...

Drag and Drop

To create a link to a specific item, or list of items if several are selected, drag the item into a text editor In this case that means the main text editors, the Notes sidebar or Bookmarks preview areas in the inspector, copyholders or those panes within Quick Reference panels. dropping them where you would like to create a link. The blinking cursor beneath the mouse pointer will indicate where the link(s) will be inserted. When creating links in this fashion, they will be automatically titled...

Select Text and Link

For cases where the item you wish to link to doesn't exist yet, or isn't readily available for drag and drop, you can also create links using a browsable menu to select the link target:

1. Either select the text you wish to link from, and then right-click on the selected text, or right-click at the point in the text where you would like to insert a named link.

2. Use the Link to Document submenu to create a new link to a chosen item. (This submenu is also located in the Edit menu.)

The conte...

Select Items and Copy

To create links to multiple items as a list, there are two approaches you can take beyond the already discussed method of dragging and dropping multiply selected items:

1. For a list of items indented by their outline levels use the Edit//Copy Special//Copy Documents as Structured Link List menu command and then paste the indented text into an editor.

2. If instead you need a flat list of links, then use the standard Edit//Copy (Cmd-Ctrl-C) command.

Wiki Link Style

If you've ever used a wiki to organise your ideas, then you know the use of links can even be a good brainstorming tool, as you can build a to-do list of things to write "remotely" with links while writing. Scrivener provides a similar mechanism via an optional method for typing in new links, even to files that don't exist yet, while you write. To enable this method, visit the Corrections tab of Scrivener's preferences, and turn on Automatically detect [[document links]] in the Data-Detection se...

Linking Without Linking

Have you ever wished you could have an automatically generated network of topical cross-reference between research, written material and notes without having to make your own links or drag your own bookmarks around? Scrivener gives you precisely that capability with its title scanning capability. Here is a simple example:

1. Create two documents in your binder, calling one whatever you want, and the second document "Link to me".

2. In the first document, type in the word "Link", or even "Link...

Links are Circular

By default, whenever you link to another document in your binder, a [Document Bookmark][Project and Document Bookmarks] will be created for the item you linked *from*, in the bookmark list of item you linked *to*. If I have a document called "Links are Circular" (and so are my references, it seems) and create a document link to another file called "Textual Marks", then if I were to click on the Textual Marks item in the binder and view its bookmark list, I would find an entry for "Links are Circ...

Removing Document Links

Removing pre-existing links

Changing a Link Target

Drag & drop and menu methods to change the link target.

Updating Link Text Automatically

When using internal links as a form of cross-referencing, a mechanism for updating the link text with revised section titles will prove useful. For example, if you change a section name from "Absinthe" to "Chartreuse", with another link pointing to it using the text, "exotic liquors", you might want to fix the link that refers to it by literal name, but not the second link which remains accurate in description.

This action requires an action from you (the software cannot determine whether "exot...

Configuring How Links Look and Feel

Most of the configuration options for links are located within the [Behaviors: Document Links preferenceoption tab][behaviours - document links]. There you can configure how links will act when they are clicked, as well as what will happen when new links are created.

The appearance of links can can be customised in the [Appearance: Textual Marks preferenceoption tab][appearance - textual marks]:

• Change the colour of "Links" in the color tab.

• Select whether links should be underscored in ...

Creating Cross-References for your Readers

Sometimes you may need a link to adjust the hyperlink text---what your readers will see---to match the given title for the section it refers to. For example, you might need the Table of Contents list to print the chapter numbers, which won't exist until you compile the draft. This method requires a few conditions to function properly:

• Link text which is solely the title of the document they link to.

• A title prefix or suffix applied to the document level that contains the links.

• Finally...

Combining Links with Placeholders

Scrivener comes packed with many useful placeholder tags that can be typed into your work and substituted for dynamic information when you compile. A simple example of this is the `\<$modifiedDate>` placeholder, which prints the modification date of the binder item you type it into. You can read more about this capability with the Help//List of All Placeholders... menu command.

An interesting capability you have at your disposal is combining these placeholders with document links. When selecti...

Creating Textual Links

There are several approaches to using the `<$include>` placeholder, each with their own distinct advantages:

* The simplest is to use document links:

1. Type the `<$include>` placeholder into the document where you wish to have the mirrored or cloned text printed. The placeholder can be the only content in that document or inserted somewhere inside of a longer text---even into a very specific context such as an inline footnote.

2. Select the placeholder in its entirety and use the document li...

How Included Text Formatting Works

Since included text can represent formatted information, styles and formatting will be determined based on usage:

• The included text will always use its character styling---even if that means "no style".

• Included text brings along is paragraph styling if the placeholder is on a line of its own. A block quote will remain a block quote when inserted.

• The paragraph style will be omitted if the included text is inline within another paragraph. It will however still bring in its own characte...

Linking Items Between Projects

To create a link to an item in another project, you have two different approaches available, both of which should be familiar from your reading of the above techniques. There really is no difference between creating an internal link between documents in one project, and creating a link between projects, in terms of what steps you need to take:

• As bookmark:

1. Open the inspector in the project you want the link to be, and click on the bookmark icon (second from the left) to load the [bookmar...

Linking From Other Programs

• To copy an external link, select the item you wish to link to and use the Edit//Copy Special//Copy Document as External Link. This plain-text URL can be pasted into link fields, text editors and so forth.

• Alternatively, right-click on the item directly in the binder, and select Copy Document Link from the contextual menu.

Advanced External URL Options

Those familiar with editing URLs may notice that the scheme uses the familiar key and value attribute system. The basic URL produced by the following commands specifies an 'id' with the UUID for the selected item. Most people will be perfectly happy with the above tools for creating links automatically, but if you would like to exert a little more control over how the links works, such as loading multiple items at once, or using splits, then the following section is for you.

The link is compris...

External URL Options

Key

Values

Description

id

Valid UUID

The UUID of a specific binder item within the project. This comes supplied with the URL when using the Edit//Copy Special//Copy Document as External Link menu command, and in most cases that will be the practical way to get that information.

doc

Binder title

Instead of referring to the internal ID you can refer to the binder title of an item. The first item in the binder matching that name will be selected. Note this is a URL, all rules pertaining to encodin...

The Collection Header Bar

MISSING_IMAGE:/path/to/gfx/binder-search_results_header.jpg

Search results header: (a) close and return to binder, (b) load results in editor and (c) sort results.

The header bar which appears between the tab list interface and the main content area (or simply at the very top when the list is closed) contains a [number of useful functions](#binder-search_results_header). In the figure, we're viewing the built-in "Search Results" list, but the same buttons will be found in all collections.

The ...

Disappearing Collection Tabs

On account of how scrollbars are hidden by default on a Mac, unless scrolling, it may not be obvious that the Collection tab interface can be scrolled, causing tabs to mysteriously disappear. If you do not like this behaviour, you can change your Mac's system settings in the General preference pane to always show scrollbars.

Viewing the Contents of a Collection in the Editor

The contents of a collection are not stuck within the sidebar. If you would like to make use of the rich capabilities afforded by the main editor's group view modes, there are three ways to do so:

1. While viewing a collection it will be simplest to click the HookArrow button in the collection header bar. If you hold down the OptionAlt key when clicking on it, the list will be loaded in the other split, opening one if necessary.

2. You can also load a collection into the editor at any time vi...

Adding To and Managing a Collection List

Here are the ways you can add items to an existing collection:

• With the tab list revealed, drag and drop a selection of icons from anywhere icons can be dragged from. They will be added to the bottom of the collection list.

If you hold over the target tab for a moment, Scrivener will switch to the tab allowing you to drop the items precisely where you want to place them in the list.


• In variation to the above, if you hold down the OptionAlt key while dragging a container to a collection ...

New items created in a collection

Within a standard collection, you may create new items using all of the ordinary tools available for doing so. Since collections are uncoupled from the binder structure in every way, new items will be placed into a folder, created for you if necessary, with a name corresponding to the collection title they were created from. These folders will be created at the top level of the binder, at the bottom of the list, above the Trash. An example might be a new text file called "Joseph" in the "Charact...

Removing Items from the List

Remove items by selecting them in the collection sidebar, and then clicking the DelButton button in the lower header bar marked (b), or by simply pressing !Delete on your keyboard.

Trashing Items From a Collection

To not only remove an item from a collection but send it to the trash as well, then use the <$custom:shortcut> shortcut.

Deleting the Collection

To delete the entire collection:

1. Select the collection from the tab list that you wish to remove.

2. Click the DelButton button in the upper title bar, marked (a).

3. You will need to confirm this action as there is no way to undo it.

Backing Up Collections

You can "back up" a standard collection by storing the list into another document's bookmark list. This can be useful if you have a lot of collections bulking up the list, and have a few that are seldom used. Here is an example of how this can be done:

1. Create a new document in the binder to store your collection list.

2. Open the [inspector sidebar and click on the bookmark tab][bookmarks tab], or press <$custom:shortcut> twice. If the list is not showing "Document Bookmarks" click the hea...

Sorting the Results in the Sidebar

The contents of search lists can be sorted by clicking on the button marked (c) in [](#binder-search_results_header). All search lists share the same sort settings. The following criteria are available:

• *Binder Order*: this is the default setting. No sorting will be done on the list, with each item listed in the order they appear within the binder from top to bottom.

• *Sort by Title*: the list will be sorted by the given names of items. If titles are changed while working in the list, it w...

Updating the Saved Search Query

You can refine or modify the search settings stored into a saved search collection:

1. You will need to start with an active search. Most likely you will wish to do so by clicking on the tab you want to modify.

2. Open the project search field if it is not visible: click the search button in the toolbar, or use the <$custom:shortcut> shortcut.

3. Modify the search settings with the magnifying glass menu. Your changes will be automatically saved into the collection.

When resetting all search...

Converting a Saved Search to a Standard Collection

Given their dynamic nature, the contents of a saved search list cannot be added to, removed from or reorganised (outside of sorting). If you wish to "freeze" a search list so that you can play with it freely, or simply to store it for later reference, there are two ways you can do so:

1. Convert the saved search to a standard type: This will destroy the saved search, so only use this method if you no longer need the search criteria. To convert a saved search result to a standard collection, se...

Deleting Saved Search Collections

Saved search collections can be removed in the same fashion as standard collections, by selecting the tab and clicking the DelButton button, marked (a) in [](#org_collections-standard_collections). Since clicking on a saved search collection automatically loads its search parameters into the project search tool, you can effectively undo this by switching the Search Results tab and recreating the collection from the magnifying glass menu.

Default New Bookmarks Folder

When creating a new bookmark note from the sidebar you will be asked where you would like to save the new note. This part of the process can be bypassed by clicking the Do not ask again checkbox below the group selection tool. From that point on, new notes created in the sidebar will automatically be filed into this folder for you.

If you prefer to have a "scratch pad" area of your project rather than using the feature to elevate globally notable files no matter where they are, you might prefer...

Adding and Removing Bookmarks

There are several ways to add a bookmark to something:

• Click on the bookmark button in the [main application toolbar](#bookmarks-toolbar_list), or use the <$custom:shortcut> shortcut to bring up the list in a floating panel. Drag and drop the resource you wish to bookmark into the list.

• When using the floating bookmark panel, you can also click on the GearMenu button to add new bookmarks. This button is functionally identical to the button featured in [the inspector][Adding Bookmarks]. It...

Removing Bookmarks

• In the bookmark list, the floating panel version of it, Quick Reference sidebar and inspector bookmark tab, you can always delete a selected bookmark with the same Cmd-DeleteShift-Delete shortcut you would use to trash an item from the binder sidebar.

• Another universal method is to right-click on the bookmark you wish to remove and select the "Delete Selected Bookmark" contextual menu command.

• As with the menu command to add a bookmark to one or many files, outlined above, the Documents...

Editing Bookmark Titles

When adding a bookmark to an external resource, a title will be generated for you depending on the type of link it is. If it is a bare URL you might get a generic title such as "Link", but files will use the file name for the title, and hyperlinks will try to use website titles or the link title automatically.

You may want to edit the title once you've added a link by right-clicking on the bookmark and selecting the "Edit Bookmark" option. If you own a keyboard with a Touch Bar, you will find a...

Organising Bookmarks

Bookmarks are organised by default in the order they were created. You can adjust their organisation to suit your uses of them. The order of bookmarks within the lists will impacts their order in every context where they are displayed. In some cases it can be a productivity boost to keep frequently used items near the top of the list, where they will be more easily accessed from tools like Navigate//Go To// submenu, which only displays the top five bookmarks.

• Click and drag to reorder bookma...

Renaming Internal Bookmarks is Renaming Items

Be aware that if you rename a bookmark that is a link to another item in the project binder, you will be renaming the *original item* as well. This is in fact less like a "bookmark" in the traditional sense of the word, and more like the kind of entry you will find in a collection: an additional placement of original the binder item.

Copying Links and URLs

Sometimes you just want a link from the bookmark, rather than doing anything with it immediately. Perhaps you want to store it in another program or load a URL into a browser that isn't your default.

1. To copy a hyperlink, suitable for pasting into documents as a clickable link with a friendly title, you can use the Cmd-CCtrl-C shortcut on any selected bookmark:

⁃ File and URL links will use the bookmark name for the link title.

⁃ Document bookmarks will use the document name. When pasted b...

Copying Bookmarks Between Items

Bookmarks of all types can be freely copied and pasted between lists, both project and document alike. They can also be dragged from one list to another---a possibility between Document Bookmarks when [Quick Reference panels][Quick Reference] are in play.

[Collection lists][Using Collections] and internal bookmarks are very similar to one another. You can almost think of bookmarks as being private collection list each item in the binder has available for use. You can freely drag and drop items ...

Sharing Bookmarks Between Projects

If you drag items from the binder of one project, into the bookmark tab of another (either project or document bookmarks are a valid target), this will store a special external direct link to the individual items you dropped. Double-clicking this bookmark will load the project if necessary and open the item you linked to within it. Read more about cross-project item links in [External Links].

External bookmarks can be copied and pasted from one project's bookmark tab to another, and in most cas...

The Title of an Item

The most important piece of metadata any item has is so fundamental you might not even instinctually think of it as being metadata: its title. The title will be used to identify the document in the many views, menus, and export methods.

Refer to [Titles and Adaptive Naming] for further information on using titles.

The Synopsis of an Item

The synopsis is a plain-text field, primarily intended to be a short summation of the contents of the document, though how you choose to use it is entirely up to you. The synopsis is displayed in three prominent areas:

1. Corkboard: used to display the content area of the card.

2. Outliner: will be placed beneath the title.

3. Inspector: if you need to reference an item's synopsis without finding it in a list somewhere, the inspector sidebar's Notes tab, or the special Synopsis split in a Qu...

Setting Up Label & Status

The next two forms of metadata, Label and Status, are flexible in how you can refer to them within a project. You can give these fields custom names and the interface and menu commands will adjust accordingly. If you wanted, you could have "POV" and "Location" instead of label and status, or "Focus" and "Type", or "Monkeys" and "Bananas" for that matter.

The documentation will of course continue to refer to them as labels and status for the sake of simplicity. They are also, after the title, th...

Label Colours

Labels are one of the most flexible metadata types in terms of how visible they are in the interface, so you can pick a colour to reflect how prominent you wish them to be. For example, richer more vibrant colours can be used among pastel choices to indicated tension, or priority.

Label colour can be expressed in the following ways:

• On the corkboard, index cards will bear a strip along the left edge of the card indicating label assignment. Use View//Corkboard Options//Show Label Color Along...

Status Stamps

As with labels, the status field can have its representative name altered to suit your project's unique requirements. By default, this field represents the status of a document in terms of its completion, such as "To do" or "Rough draft", but this field can be used for whatever purpose you desire.

Unlike the label, there is no corresponding colour, and so its display potential is more limited. On the corkboard, they can be displayed as an optional "stamp" across the face of the card with the Vi...

Keywords

Each document can have a list of keywords associated with it (what you might be more familiar with as "tags" in some other programs). These are useful for making documents easily searchable---for instance, you can list all characters and locations connected with a scene in the keywords even if they are not mentioned explicitly in the text. Creative uses for keywords also include extended status control, plot management, and whatever else you can think of.

Their biggest advantage is in non-exclu...

Custom Metadata

For all of the things we couldn't think of. With four different types of fields and extensive support for searching and filtering, custom metadata picks up where the stock tools let off. Four different field types can be used to create however many fields you need in a dedicated form built into the inspector pane, and as sortable outliner columns or tools for filtering corkboard and outliner views and project searches:

• Text: a simple text field. This tool is great if you need to mark section...

Exporting Metadata

All metadata can be exported in a variety of ways, usually text-based for maximum compatibility, so you needn't fear having important organisational information getting locked-in with the project format. Metadata can be exported in the following fashions:

• Compiling: when compiling the Draft, enabling metadata export is an optional feature of the Formatting pane. The various types of metadata will be exported into the Draft in a variety of ways best suited to the type of data involved. Additi...

Project Keywords Panel

The Project Keywords panel holds all of the keywords in use by the project. As you assign keywords to items, using the [Inspector's Metadata tab][Keywords Pane], they will be added automatically to the central project list, making it a complete reference of all keywords in use within the project (you can also create keywords for future use here, without assigning them to anything yet). The panel is also how you will handle bulk management of keyword assignments for many items at once.

You can a...

Changing Keywords Globally

Keywords can be centrally managed from the project keywords panel. Intuitively, if you change the name of a keyword it will be altered throughout the entire project rather than becoming a new keyword that nothing is assigned to. Likewise changing the colour is a global setting. To do either, first use the Project//Show Project Keywords menu command to load the keywords panel.

To change the name of a keyword:

1. Double-click on the name of it in the panel, or press the Esc key, and edit the la...

Deleting a Keyword from the Project

To fully remove a keyword from a project, not only from the master keyword list but from every item that was using it as well, you will need to use the Project Keywords pane:

1. Open Project//Show Project Keywords (<$custom:shortcut>).

2. Select the keyword(s) you wish to remove. You can select multiple keywords with the Shift and CmdCtrl keys.

3. Click the DelButton button in the footer bar, or press the !Delete key on your keyboard.

For keywords that were not assigned to any items in the ...

Searching by Keywords

Although it is always possible to create your own searches for keywords by hand, the project keywords window provides a convenience for keyword usage in your project. Simply click on the keywords you need to hunt down, and click the magnifying glass button in the bottom right-hand side of the panel.

There are optional search modes that can be accessed by right-clicking on the button. Upon selection of one of these modes, the desired search will be immediately used, or updated if the search list...

Importing and Exporting Keywords

If you would like to copy keywords from one project into another, follow these steps:

1. Open both projects, and in each, use the Project//Show Project Keywords menu command to open their respective keyword lists.

2. Select the keywords you wish to copy from one list and drag and drop them into the other project's keyword list. Colour assignments will be preserved.

This will always duplicate the keywords into the new project, so existing keywords with the same name will not be overwritten.

...

(see also)

• [Project Search]: although the panel has a useful button for invoking a project search, it might be a good idea to know how that feature works as well, so you can fine-tune results if needed.

• [Keywords Pane]: where you will most often interact with keywords is in the inspector pane, assigning them to documents directly.

Starting a New Search

There are two ways to start a new project search:

1. Click the ["Search" button in the toolbar to reveal the search field](#binder-project_search_button).

2. Use the command, Edit//Find//Search in Project... (<$custom:shortcut>), to open the field and place the cursor there in one move.

MISSING_IMAGE:/path/to/gfx/binder-project_search_button.jpg

The default project search field, with the "Search" toolbar button above.

Now all you have to do is start typing, and as you type matching document...

Finding matches in the editor

In addition to highlighting all matched text for easy visual recognition, for your convenience, the text you searched for will be automatically loaded into the text find tool for you. This means you can immediately use the keyboard shortcut to find the next search result within the document (Cmd-GF3). Since searching the project can examine many different types of elements, the search result itself may not be in the primary editor---it might be a label or a keyword ...

Browsing and Sorting Results

While typing, you can flip through search results with the UpArrow and DownArrow keys on your keyboard, loading the result into the currently active editor. Otherwise, you can use a search result list just like you would use the binder normally. Refer to the section on [Selecting Items][] for tips on viewing multiple items.

MISSING_IMAGE:/path/to/gfx/editor-next_previous_doc.jpg

Use the "Previous" and "Next" document buttons to flip between search results.

While working in the editor, the you ...

Locating Results in the Binder

In addition to locating and reviewing content itself, you might want to use the Project Search feature purely as a way of locating and selecting matching items in the binder itself. Since searching uses the binder sidebar itself to show the result list, you will need to use the Navigate//Reveal in Binder (<$custom:shortcut>) command to close search results and return to the binder with each selected result highlighted in the binder. This command will expand any hierarchy necessary to fully revea...

Refreshing Results

As you type, the contents of the search result list will refresh dynamically, narrowing down the result efficiently. However once you've stopped typing, actions taken elsewhere in the project window that might impact search results will not update the list. This allows you to work off the list without it constantly changing. If you do want to refresh the results, simply click into the search field and hit the !Return key.

For cases where you've loaded search results into an editor (as above), y...

Taking Results to the Editor

In some cases you may want a little more space to work with your search results, or access to some of the powerful capabilities afforded by the outliner and corkboard view modes. At any time, click the HookArrow button marked (b) in [](#binder-search_results_header) to load the contents of the sidebar list into the active editor.

This is also a great way to search *again*, if the initial search result was too broad and you want to search by a second factor. With the focus in the editor, press <...

Search In

The initial section of the options menu is for selecting the type of element that project search should look within. NOTE//WINDOWS// Perhaps they will create a way for doing this, but it probably won't be the Alt key. Select multiple elements by holding down the Option key and clicking on a type. Option clicking can also be used to turn off an extra field without disturbing the total selection. To return to using a single element, either select "All", or select any field without using the Optio...

Operator

Select the method by which your text will be used by the search engine:

• Any Word: the default search method. Queried documents must contain at least one of the words typed into the search field. Analogous to logical OR.

• All Words: every word entered into the search field must be present. Documents which only match some of the words will not be returned. Words can be entered in any order. Analogous to logical AND. You can also enter double-quoted phrases mixed in with single words, working...

Options

Provides a few extra options, as well as setting scope limiters. Scopes instruct the search engine to only scan select parts of your binder.

• Search Draft Only: will only look in the "Draft" folder of the binder. Note that if the name of draft folder has been changed in the project, the title of this option will reflect that name change.

• Search Binder Selection Only: preselect items in the binder and then perform the search against those items only. This selection is explicit, not implicit...

Resetting Search Options

To reset all search settings to a few simple default settings, select the "Reset Search Options" command in the magnifying glass menu. This will change the settings to the following settings:

• Search in: All

• Operator: Any Word

• Options: all disabled, save for the two toggles to search for both "included" and "excluded" documents.

Mixing exact phrases with all words

If you want to find every document containing a word as well as a particular phrase, put the phrase in double-quotes while leaving the search operator set to "All Words". The term `Bob "black car"` would locate all documents referring to a "black car" that also mention Bob. The quotes cause the phrase to be treated as a word.

Finding things that don't have a word

Sometimes the most efficient way to make a long list of search results shorter is to omit the most common word that you aren't looking for. Place a hyphen directly in front of such a word to remove it from the list of possibilities. A simple example would be to search the "Text" for `Lydia -Dovahkiin`, to find all documents mentioning Lydia that do *not* also refer to a certain individual named Dovahkiin.

This technique can be used with the Any Word and All Word operators. It can also be combin...

Finding everything

To search for everything, type in a single asterisk (\*) into the search bar. It can sometimes useful to build a flat list of everything in the entire project, usually in conjunction with loading the search result into an editor, where you can do such things as sorting by label to view your binder clustered by label assignment, or by Modified Date to review recently changed files.

Finding everything by type

The above method of using an asterisk can be combined with all available search options. For example: you can find all items in the draft folder alone, or all items that have had a label (any label at all) assigned to them, or with the "Invert Results" option, you can find all item's that *don't* have a label assigned yet.

Searching by modification and creation date

A common desire is to locate items that have been modified recently, or to find files that were created within a certain window of time. Scrivener supports these operations and many more besides, using its special date search syntax.

When suffixing a search term with either of the keywords `mdate:` or `cdate:`, project search will combine the current "Search In" settings to also search for Modified Date or Created Date respectively. When used alone, they will simply return a list of all documen...

Combining Search Terms

Most of the techniques we've discussed can be combined together to create more specific and complicated search criteria. Here are some examples:

• If you are searching in the "Notes" field for the word "ToDo", but only want to find those documents that haven't been modified recently, you would use the term, `ToDo mdate:<6m`, which would find every document with "ToDo" in the inspector notes that hasn't been modified in the past six months.

• You can search for all documents with the "Needs Fo...

Date Search Syntax

Search Term

Description

**By a Given Date**

YYYY-MM-DD or YYYY/MM/DD

Find everything from a specific day, such as 2017-04-08, which will find everything on the 8th of April, 2017.

YYYY

All edits found within the specified calendar year.

**By a Relative Date**

#d

Find everything written since the number of days specified. Eg. "7d" would find everything edited within the last week.

#m

As above, but using months. Eg. "6m" will find everything edited in the past half year, or six months.

#y

As abov...

Replace All Scope

These two options determine the scope of how much text will be impacted when clicking the Replace All button:

* Entire Document: all of the text in the current view (which may be multiple documents when using Scrivenings mode) will be searched and replaced.

* Selected Text: only the selected text will be searched and replaced. Since this command will remove the selection, it means you will need to apply a new selection if you intend to continue searching and replacing this way.

Find Options

These options impact how the text within the "Find" field is treated. They are used for both regular searching and replacing:

* The mode dropdown at the top contains the following options:

* Contains: the tool will find any sequence of text that matches what has been typed into the "Find" field, even if it is found within a word.

* Starts with: text will only be found if a word begins with the supplied text.

* Whole word: only words that match the text from start to finish will be matched. ...

When Loading Items

At any time you can modify how selection works in the binder sidebar and other contexts, causing the action to impact the other split, by holding down the OptionAlt key when clicking. Here are the contexts and methods this blends with:

• Clicking on individual items in the binder.

• With the combiner modifier keys, add or remove from [Multiple Selections] in the other split. Opt-Cmd-ClickAlt-Ctrl-Click will add or remove the item you clicked on to the other split's group view (forming a group...

Changing How the Binder Works Persistently

By default the active split is synonymous with the targeted split. If you click in the top editor the header bar is shaded blue and is underlined in blue. You wouldn't be blamed for thinking that was one visual effect, but in fact it is two. The blue shade indicates the binder will load things into that editor when you click on them (targeted), and the blue underscore indicates that this is the split you're currently working within (active). If we can tell the binder to only target one split but...

Default

MISSING_IMAGE:/path/to/gfx/layouts-builtin-default.jpg

The "Default" built-in layout.

The first and most important layout to be aware of is the one that gets things back to ground zero. The "Default" layout is designed restore a project window to a basic look, removing the non-active split view, closing all copyholders and opening the inspector and binder. It will also clear those navigation settings that modify how the project window behaves when you click on things---in the exact same fashion...

Three-Pane (Outline)

MISSING_IMAGE:/path/to/gfx/layouts-builtin-3pane_outliner.jpg

The "Three-Pane (Outline)" built-in layout.

Three-pane browsers are a popular way of navigating through large amounts of information. They typically feature a sidebar (much like the binder) for selecting folders, then display the contents of that folder in a second view, and finally clicking on things inside of that view will automatically load the contents of what you click on into the third pane. Here are the settings it applies:

...

Three-Pane (Corkboard)

This layout is functionally identical to the "Three-Pane (Outliner)", save for using a stylised corkboard view for primary navigation, rather than an outliner. If you prefer the additional visual display of metadata that the corkboard affords you, this can make a good alternative. It temporarily changes the following aspects of the corkboard:

• View//Corkboard Options//Cards Across will be set to "1".

• The Size to fit editor setting will be enabled, from within the [Corkboard Options] panel....

Editor Only

MISSING_IMAGE:/path/to/gfx/layouts-builtin-editor.jpg

The "Editor Only" built-in layout.

Does what it says on the tin. This very simple layout simply removes both sidebars, closes the split view and any copyholders. Which split it chooses will depend on what you are currently working with. It will favour the split that is showing a text editor or Scrivenings session. If both (or neither) splits match that description, then the active split will be used. Lastly it will set the group view mode to...

Corkboard Only

MISSING_IMAGE:/path/to/gfx/layouts-builtin-corkboard_only.jpg

The "Corkboard Only" built-in layout.

Much like the "Editor Only" layout, but aiming to provide a clean view for focussing on structure, rather than content. If relevant, when choosing which split to focus on, the layout will select the split with a corkboard. It will otherwise use the active split, changing the view mode to Corkboard if necessary. If you were editing a file then the layout will select the *parent* group, scrolling t...

Centered Outline

MISSING_IMAGE:/path/to/gfx/layouts-builtin-centered_outline.jpg

The "Centered Outline" built-in layout.

The main purpose of this layout is to quickly and simply display a very clean outline view with only the Title (and optionally Synopsis) column visible and the View//Outliner Options//Center Content menu toggle enabled. The editor space will be cleaned up, closing splits if necessary and removing any copyholders.

As with the "Corkboard Only" layout, the split showing an outliner will be pref...

Dual Navigation

MISSING_IMAGE:/path/to/gfx/layouts-builtin-dual_navigation.jpg

The "Dual Navigation" built-in layout

If you've ever found yourself wishing that you could have a kind of second binder, so that you could browse and edit more than one file at once, this layout may do the trick. You can think of this layout as roughly dividing the project window down the middle into two separate workflows:

• On the left side, the binder and the left split will be bound together exclusively. You can use it for tex...

Refining A Built-In Layout

You may very well find that you like the basic idea of one of our built-in layouts, but would like to make adjustments to how it works. Although you cannot modify the built-in layouts, for the most part this can be done simply by creating your own layout after making the desired modifications to the project window, as described earlier in this section.

Although they work similarly, built-in layouts are not the same as the layouts you create, and they have some characteristics you won't be able ...

Hiding the Built-In Layouts

Once you've established a number of your own layouts, you may want to hide these starter layouts to clean up the menus:

1. Use the Window//Layouts//Manage Layouts... menu command (<$custom:shortcut>) to bring up the layout management window.

2. Click the GearMenu button and select the "Hide Built-In Layouts in Menus" command.

You can always bring them back with the "Show Built-In Layouts in Menus" command.

The Header Bar

MISSING_IMAGE:/path/to/gfx/quickref-header_bar.jpg

The Quick Reference header bar.

Along the top of the window, below the Format Bar if you have displayed it, you will find [a simplified header bar](#quickref-header_bar).

The icon to the left of the title can be dragged, acting as a proxy for the file it represents. It can be dragged to the binder to move the file to the location you drop it, it can be dragged into a bookmarks inspector pane, etc. To "dock" a Quick Reference panel back into th...

The Footer Bar

The footer bar, running along the bottom of the view, has three primary elements:

1. The "Project Bookmarks" button. This is described [below][The Bookmark Sidebar].

2. This area will display either statistics or scripting element dropdown menu (which can be called up with the <$custom:shortcut> shortcut, just as in the main editor), depending upon the editor mode.

When viewing a multimedia file, [the "Pause and Rewind" toggle button][Viewing Multimedia Documents].


3. Finally, along the ri...

Quick Reference Mini-Inspector

Quick Reference panels can display inspector metadata for the document you are working with in the panel.

MISSING_IMAGE:/path/to/gfx/quickref-example_window-with_metadata.jpg

A Quick Reference window can display a simplified inspector along the bottom or to the right (as shown).

The panes you can make use of here are not organised in precisely the same fashion as the inspector itself, on account of their being divided into specific areas of content. For example the "Notes" tab in the inspector...

The Bookmark Sidebar

Any Quick Reference window can easily browse through project bookmarks (assuming it can display the type of bookmark in question). Click the bookmark button, marked (c) in [](#quickref-example_window) to toggle the sidebar visibility, or use the <$custom:shortcut> shortcut. Click on the bookmarked document you wish to edit to view it in window.

For detailed reference on the sidebar itself, refer to [Working with Bookmarks in a Quick Reference Panel].

When using the bookmark sidebar, the earlie...

Floating Panels for Maximum Visibility

Quick Ref panels have an additional capability in the Window//Float Quick Reference Panels menu toggle (<$custom:shortcut>). When set, all of a project's panels will "float" over all other windows in Scrivener. Floating can be particularly useful when the project window itself is as large as the entire screen, or in !composition mode, where the backdrop would ordinarily hide the panels. Consider toggling float on and off as needed to bring the panel workspace to the front, and then disable it an...

Displaying Research in Quick Reference

It's not just about the text. These windows can also act as capable PDF and image viewers, as well as working with other multimedia. For further information on the particulars of how they work inside the editor area, refer to [Viewing Media in the Editor].

The Window//Zoom menu command, when use on a Quick Reference panel that is viewing an image or PDF will expand or contract the size of the window to fit the content. If you would prefer things work the other way around, double-click on the im...

Setting Text Zoom

Although there is no place for the visible zoom control like in the main editor footer bar, you can independently zoom the text scale within each Quick Reference panel as needed, using the View//Zoom// submenu, or the <$custom:shortcut> and <$custom:shortcut> shortcuts to decrease and increase the magnification levels, respectively.

Inspector Keyboard Shortcuts

Shortcut

First Use

Second Use

<$custom:shortcut>

Notes & Synopsis tab

<$include>

<$custom:shortcut>

Bookmarks tab

<$include>

<$custom:shortcut>

Metadata tab

<$include>

<$custom:shortcut>

Metadata tab

<$include>

<$custom:shortcut>

Snapshots tab

<$include>

<$custom:shortcut>

Comments & Footnotes tab

<$include>

<$custom:shortcut>

Notes & Synopsis tab

<$include>

Inspector Keyboard Shortcuts

Synopsis Images vs Text

In the "Synopsis" section header, along the right-hand side, is a button that when clicked will toggle between using a text or image synopsis for this item. You can also use the Cmd-7Ctrl-7 shortcut, or the matching button on the Touch Bar, when keyboard focus is in the inspector and this tab is showing. Graphics that have been imported into the binder show a thumbnail of themselves on the corkboard and inspector by default. Use this same button to disable that behaviour for an image and use a t...

Adjust Synopsis Image Cropping and Size

You can adjust the size, placement and cropping of the image by right-clicking on it within the inspector. These adjustments also impact the way the image will be displayed on the corkboard:

Scale to Fit

: The longest edge of the image will be sized so that it fits within the shape of the index card in the inspector, thus showing the entire image.

Fit Horizontally

: The width of the image is sized to fit the width of the synopsis image area. This may mean portions of the image are cropped alon...

Auto-Filling Synopsis Text

If you would prefer to use an excerpt from the main text area, there are two ways to go about doing so:

1. Select some text in the main editor and use the Documents//Auto-Fill//Set Synopsis from Main Text menu command (<$custom:shortcut>) to fill the synopsis with that text.

2. Drag and drop text from any source into the synopsis text area to append it at the drop location---just as with any text editing area.

What if I just want the first bit of the text shown?

If no selection is made, a po...

(see also)

• [So What are Index Cards, Anyway?]: introductory text on the anatomy of an index card---primarily as it relates to the corkboard, but since this copy in the inspector is your portal to that "same" card it's good to know what it represents.

• [The Corkboard] & [The Outliner]: knowing where this synopsis card shows up is essential to using it effectively.

• [Appearance: Index Cards !preference pane][appearance - index cards]: where much of how an index card looks & feels will be configured.

(document notes settings)

• [Editing: Formatting: Notes][Editing - Formatting - Notes]: select the default font and size for all new document notes (also impacts scratch pad).

• [Appearance: Inspector & Notes][appearance - inspector & notes]: adjust the text colour, background colour and whether or not rules are added, for a "canary pad" look.

Viewing Bookmarked Folder Contents

MISSING_IMAGE:/path/to/gfx/inspector-bookmarks-folder_menu.jpg

Easily preview child items from bookmarked folders.

When bookmarking folders you will find a [chevron button to the right of the row](#inspector-bookmarks-folder_menu). Click this button to choose from a menu displaying a list of subdocuments from that folder. The chosen item will be displayed in the bookmark preview area below the list. You can more easily include whole categories of information in your inspectors with this capabil...

Editing Bookmarks

Any existing bookmark's title can be edited by pressing the EscF2 key with a single bookmark selected. To finish editing, press the same key or click elsewhere to confirm.

<$include>

MISSING_IMAGE:/path/to/gfx/inspector-bookmarks-edit.jpg

Sometimes giving a file a friendlier name is essential.

For external bookmarks (those pointing to any resource not located within the current project's binder) there is an additional editing method for when you need access to or wish to modify the URL:

1. ...

Deleting Bookmarks

To delete bookmarks, select the ones you wish to remove and click the DelButton button, right-click and select "Delete Selected Bookmark", or tap <$custom:shortcut>.

Further Bookmark Management Tips

For more bookmark management techniques (such as copying and pasting) which can make use of addition tools beyond the inspector tab, refer to [Managing Bookmarks].

Assigning Keywords

There are several ways to add new keywords to your document:

• Click the AddButton button in the keywords table header bar to type in a new keyword. As you type, any existing keywords that match what you are typing in will be suggested as an auto-completion (this is case-sensitive). You can also use the !Return key in the table to add new keywords.

• Drag the keywords from the [Project Keywords Panel] panel to the document header bar, its name in the binder (this latter use allows you assign ...

Managing Keywords

Keywords can be reordered within the list using drag and drop. The order will impact the following areas of the project window and elsewhere:

• Index cards on the corkboard, when View//Corkboard Options//Show Keyword Colors is enabled. Since only a few keywords can be shown in this context, putting the most important keywords you track visually near the top of the list will be beneficial.

• The order of display in the View//Outliner Options//Keywords listing of the outliner view.

• When expo...

Removing Assignments

Keywords can be unassigned from an item by selecting them in the keywords list of the inspector and clicking the DelButton button above them, or pressing the !Delete key on your keyboard. You can also [bulk remove multiple keywords from many items at once using this panel][Project Keywords Panel].

This will not remove the keyword from the project, even if it is the last item that was using it. To fully remove a keyword (and remove it from all items using it), see [Deleting a Keyword from the Pr...

Browsing and Adjusting Change Markings

When in comparison mode, two arrow buttons which will appear to the right of the GearButton. With these you can jump from one change to the next within the snapshot preview area. You can use <$custom:shortcut> and <$custom:shortcut> to navigate between changes, as well---and when viewing a comparison in the main editor or copyholder you will always need to use these shortcuts.

As for how changes are marked, in some cases, the type of editing done in between snapshots will present a confusing re...

Hiding and Revealing Notes

Notes can be independently collapsed or revealed using a few different methods:

• Click on the triangle to the left of the heading of the note you wish to expand or collapse.

• The LeftArrow and RightArrow keys will expand or collapse all selected notes.

• OptionAlt-Click on any of the note disclosure arrows to expand or collapse all notes in the direction taken for the note arrow you clicked on.

• The View//Outline//Expand All (<$custom:shortcut>) and Expand All (<$custom:shortcut>) shortc...

Note Formatting

When working between multiple sources and programs, you may notice that footnotes will take some rich text formatting, and may end up looking mismatched with the other footnotes you've created. You can revert footnote and comment formatting to default settings:

1. Select the notes you wish to clean up.

2. Right-click on the selected notes and select the "Convert to Default Formatting" command.

The global default font for footnotes and comments can be modified in the [Editing: Formatting !pre...

Setting Colours for Linked Comments

Linked comments, as with inline annotations, can be assigned a colour. By default, when you use one of the previously mentioned techniques for adding a note, the highlighter anchor box in your text will be yellow, as will the corresponding note in the inspector. These two colours will always match, making it easier to see where you are in your text in relation with your notes.

To change the colour of a note, right-click on it in the inspector sidebar, or in the shaded header bar area when using...

Inspector Footnote Numbering

The View//Text Editing//Show Compiled Footnote Numbers in Inspector project setting will add a static footnote number to the upper-right corner of each footnote, when compiling with this feature enabled. Refer to [Compiled Footnote Numbering] for further information on this capability.

Convert to Comment or Footnote

Right-click on any selection of notes to convert them between footnote and comment types. This can be done freely at any time, and if a custom colour has been applied to a comment it will be remembered in the background in case you convert it back from a footnote in the future. For further information, refer to [Converting Notation Between Types].

Sync with Dropbox

This should probably go without saying, but there are two basic ingredients you'll need to get this all working:

• First thing you will want to do is set up Scrivener for iOS so that it is hooked up to your Dropbox account. If you are unsure of how to do that, please consult the built-in tutorial on your device, or tap on the circular arrow icon in the main project screen and walk through the setup screens.

• On your computer, you'll need Dropbox installed and running in the background.

In t...

Managing Projects Directly (iTunes)

Dropbox may not work for all of your projects, or you might be unable or unwilling to use it at all. No fear! You still get all of the goodies, but you'll need to handle copying projects to and fro.

Updating Projects with Mobile Changes

Main section describing what happens when a modified project is synced.

Preparing the Folder

The first thing you will need to do is select a new, empty folder on your disk. Scrivener will manage all aspects of this folder from this point forward; it should be used for no other purpose. Click the Choose... button, and point the file browser at the location where you would like to host the sync folder. Keep in mind that the folder you create will need to be dedicated to this Scrivener project, and so must be initially empty. **Never select a folder which has already been used to synchroni...

Options

Sync the contents of the Draft folder

: Enabled by default, the contents of the "Draft" folder will be kept in sync with the folder when this is on.

Sync all other text documents in the project

: Keep the rest of the project's text files (only) up-to-date with this option. This also activates the settings in the "Import" section, below.

Sync only documents in collection

: The project must have at least one collection (other than Search Results) in order to enable the option. When enabled, onl...

Import

This section will be disabled unless the Sync all other text documents in the project option is enabled, above. The setting determines where new files you've created within the "Notes" subfolder will be imported into the binder (the "Research" folder by default).

The dropdown will only display eligible folders and file groups, unless you disable the Only show containers in destination list option, below the dropdown.

Format

In the final section of the sync folder window, we can set up how the files themselves will be created and read from the sync subfolders. You could set the draft folder to use Fountain format for screenplays, but leave your research and notes as RTF files, for example.

There are four file formats available, and depending on your intended purpose, selecting the right option will be important:

• *Plain text (TXT)*: The resulting files will be standard, plain-text files in the UTF-8 encoding. If...

First Run

Once the "Sync" button is clicked, Scrivener will export a file for every item set to be synced. The feature will create one or more of the following three subdirectories within the folder to store the synced files:

1. "Draft" - stores documents contained inside the project's Draft folder. New files placed into this folder will be imported into the very bottom of the draft folder in the binder when syncing them in.

2. "Notes" - stores text documents contained elsewhere throughout the project....

Working with the Sync Folder

This is the most open-ended part of the process, given that we're working with regular old files and folders at this point. They can be edited using other software, shared with colleagues or your editor, posted to a cloud share, or even zipped up into an archive and sent via email. The important ingredients are the modification dates on the files, the file names themselves and their organisation into folders.

Can I change the names of the files?

It is very important to never change or remove th...

Bringing Changes Back to the Project

The default setting, Check external folder on project open and automatically sync on close, will keep the project and the disk up to date with each other automatically whenever you open the project or close it. Beyond this, there are three ways to ask the project to sync with its external folder immediately:

MISSING_IMAGE:/path/to/gfx/toolbar-folder_sync.jpg

Add the "Folder Sync" button to the toolbar for one-click syncing.

• The File//Sync//with External Folder Now menu command.

• Click on ...

Working with Updated Documents

MISSING_IMAGE:/path/to/gfx/sync-comparing_changes.jpg

Comparing synced changes using snapshots.

In [](#sync-comparing_changes) we see a few different features coming together to create one example workflow for reviewing changes:

*Updated Documents list*: this is a listing of every binder item that was changed during the synchronisation (it will always appear automatically when applicable). It temporarily replaces the main binder until you click the CloseButton button on the left side of the si...

Disabling Synchronisation

If you merely wish to disable syncing for a time, the entire feature can be rendered temporarily inert by unchecking the Sync files in this project with external folder option at the very top of the folder sync settings window.

To sever the connection with between the project and the sync folder permanently, click the Clear button in the setup screen, alongside the area where you would choose where the sync folder resides. You will be presented with two options:

Clear Only

: The folder that th...

Managing Automatic Snapshots

When Scrivener creates snapshots it will use standard naming conventions. If Scrivener makes a mistake and syncs text in the wrong direction these snapshots can be used to restore that text where needed:

• "Pre-Sync External File Version": when the copy on the disk is scheduled to be updated by revisions from the project, this snapshot will contain the contents on the disk prior to doing so.

• "Pre-External File Sync Overwrite": this snapshot records the state of the text from the binder item...

Limitations

There are a few general limitations that you should be aware of:

• This is a *content based* tool. It exports files with the text content of the binder items you select for syncing. Only the main text area will be exported, no meta-data such as notes, synopsis, keywords and so forth will be included.

• In extension of that concept, this is not a tool for implementing binder-level changes. The sync folder creates a flat list of files containing the content of those items, from wherever they ma...

Character Selection Shortcuts

Action Taken

Keyboard Shortcut

Extend current selection in the direction of the arrow key that is used.

Shift-Arrow

Extend the selection by word.

Shift-Opt-LeftArrow or RightArrow

Extend the selection by paragraphs.

Shift-Opt-UpArrow or DownArrow

Select from the caret position to the top or bottom of the editor, respectively

Shift-Cmd-UpArrow or DownArrow

Select from caret position to beginning or end of the soft-wrapped line respectively.

Shift-Cmd-LeftArrow or RightArrow

Select from the caret...

Character Selection Shortcuts

Action Taken

Keyboard Shortcut

Extend current selection in the direction of the arrow key that is used.

Shift-Arrow

Extend the selection by word.

Ctrl-Shift-LeftArrow or RightArrow

Extend the selection by paragraphs.

Ctrl-Shift-UpArrow or DownArrow

Select from the caret position to the top or bottom of the editor, respectively

Ctrl-Shift-Home or End

Select from caret position to beginning or end of the soft-wrapped line respectively.

Shift-Home or End

Extend the current selection using the mous...

Character Deletion Shortcuts

Action Taken

Keyboard Shortcut

Delete to beginning of current word

Opt-delete

Delete to end of current word

Opt-Fn-delete or Opt-Del

Alternate forward character delete

Ctrl-D

Alternate backward character delete

Ctrl-H

Delete to beginning of soft wrapped line

Cmd-delete

Delete to end of paragraph (not line)

Ctrl-K

Transpose letters around caret

Ctrl-T

Character Deletion Shortcuts

Character Deletion Shortcuts

Action Taken

Keyboard Shortcut

Delete to beginning of current word

Ctrl-Backspace

Delete to end of current word

Ctrl-Del

Character Deletion Shortcuts

Using the Spell Check Window

MISSING_IMAGE:/path/to/gfx/editing-spell_check_window.jpg

The traditional spell check window is useful if you prefer to spell check at the end of the session.

If you prefer to spell check in one go at the end of a writing session, you might prefer to use [a traditional window](#editing-spell_check_window) for doing so. Use the Edit//Spelling and Grammar//Show Spelling and Grammar menu command (<$custom:shortcut>). (You can also use the Check Document Now command (<$custom:shortcut>), to jump fr...

Spell Check Contextual Menu

With active spell check while typing enabled, when you misspell a word while writing, it will be underscored with a wavy red line. Whenever you see a word with this marking, you can right-click on it and the contextual menu will contain best-guess suggestions for which word you were aiming for.

When right-clicking on a misspelled word, a few convenience commands will also be provided, for "Learn Spelling" and "Ignore Spelling". These function the same as the analogous buttons described in the p...

Text Editing Contextual Menu

Hyperlink Selections

When the selection is entirely or partially within a hyperlink (not an internal document link), then additional link management options will be provided for at the top of the contextual menu:

Images Contextual Menu

These options appear when right-clicking on an image that has been placed [inline in the text editor][Working with Images]:

Document Link Selections

When right-clicking on document links, that is internal links pointing to another resource within the same project, a few additional commands will be added to the menu.

Tables Contextual Menu

When right-clicking within a table in the editor, additional options will be provided in a "Table" submenu:

Table...

: Accesses the table palette, which provides formatting, cell dimension, and nesting, and cell split and merge features.

Add Row Above|Below

: Will insert a new table row of empty cells above or below the row in which you right-clicked.

Add Column Before|After

: Inserts a new table column of empty cells to the left or right of the column in which you right-clicked.

Move Row|Co...

Lists Contextual Menu

Only one extra option over the base text system has been added for list management:

Re-number List

: In rare cases, especially when pasting lists from other word processors like Word, list numbering will sometimes not register properly. Use this command to attempt to repair these lists.

Typewriter Scrolling Settings

There are a couple of settings that adjust how typewriter scrolling works, both found in the [Editing: Options !preference tab][editor - options]:

• It is possible to adjust vertical position of the typing line if you'd rather something other than the middle. Use the Typewriter scroll line option to select from quarters, thirds or the middle.

• If you would rather typewriter scrolling rigidly adhere to the scroll line rather than adapting whatever line you position the cursor on, then enable ...

Splitting Manually

To split a chunk of text in Scrivener into two pieces you will first need to place the caret at the precise point in the document where you wish the split to occur. If you select a range of text, the *start* of the selection will be considered the caret point, for purposes of splitting. Once the selected location has been chosen you can use one of two methods to split the document:

• Documents//Split//at Selection (<$custom:shortcut>): <$include> It can be useful to think of splitting in terms...

What Splits Off

Splitting a document is considered to be a text-based operation. The text itself will be split at the cursor or selection, and the Synopsis and Notes content will remain in the original half. Snapshots, also being a component of the document's text, will remain in the original half.

As for the rest, you can think of splitting as being very similar to duplication. Document attributes and metadata will all be copied into the second half. This includes label colour, keywords, custom metadata, comp...

Tab Stops

Left stops can be created by double-clicking anywhere in the numbered area, or by right-clicking in the ruler and choosing a type. Once placed, they can be moved via click-and-drag, and the numerical value of its position will be printed above the mouse pointer as you drag. These will be depicted by type using icons. The four tab stop types available are:

1. Left: This is the standard type. Text will be left-aligned, with the first character indented to the position of the tab stop.

2. Center...

Indents

There are three indenting controls, not to be confused with margin controls (which Scrivener's ruler does not address). Indenting is the action of offsetting text a defined distance from the margin. A left indent pushes the text boundary toward the right, away from the left margin. A right indent pushes the text boundary toward the left, away from the right margin.

In addition to the two primary indent marker is the first-line indent marker. This will *only* indent the first line of a paragraph...

The Tabs and Indents Tool

MISSING_IMAGE:/path/to/gfx/formatting-tabs_and_indents.jpg

The "Tabs and Indents" tool allows for precision adjustments.

If you find working with the ruler tool difficult in terms of getting precise placement, or seeing what you are doing with overlapping close-by markers, the Format//Paragraph//Tabs and Indents... utility provides a place where you can insert measurements directly and even create stock tab stops on an interval.

All measurements are made from the left edge of the ruler as show...

Adding Links Manually

Links need not be attached to visible URLs in the text. You can attach a link to any form of text:

1. Select the text you wish to link from in your editor.

2. Used the Edit//Add Link... menu command.

3. Select the type of link you wish to create (if you have the full URL ready to paste, use the No Prefix option).

4. Type or paste the URL into the text field and click OK.

This method can also be used to create a fully linked and visible URL in the editor as well. Omit the first step and cal...

Editing Links

To edit an existing link, including one created automatically by the software:

1. Place the cursor anywhere within the range of a link, or select it completely. If you select only a portion of the link, just that portion will be changed.

2. Use the Edit//Edit Link... menu command, or right-click and select the command from the contextual menu.

3. Modify the link settings and click OK.

Removing Links

To get rid of a link, or maybe many links at once (perhaps to clean out links from a web page pasted into the editor or imported as text):

1. Select the text from which you want to remove links, or right-click on the link you want to remove.

2. Use the Edit//Unlink menu command, or select the same command from the contextual menu.

Links Aren't Fully Removed?

Some browsers and text editors will not only link text, but add formatting to the text that looks like a link as well. If you strip out...

Managing Font Sizes in the List

If you would like to add or remove font sizes from the format bar, you would do so to the entire macOS via the system palette:

MISSING_IMAGE:/path/to/gfx/system-font_size_editing.jpg

Adding "16pt" as a new font size to the system.

1. Bring up the Format//Font//Show Fonts panel (<$custom:shortcut>).

2. Click the GearMenu button and select "Edit Sizes..."

3. Type in a new font size in points in the New Size field, and click the AddButton.

4. When finished, click Done.

You should now see 16p...

Paragraph and Character Styles

As in many programs with stylesheets, there are two fundamentally different types of style that get used, though one can have attributes of both:

MISSING_IMAGE:/path/to/gfx/styles-paragraph_and_character_types.jpg

The two style types and their combinations, as they would appear in the Format Bar.

• *Paragraph styles*: chiefly concerned with the overall shape text within the unit of measurement referred to as a paragraph. The indents settings, first-line indents, block indent, hanging indent, ...

What About Fonts?

With the exception of the code block mention above, you have noticed that I haven't used the word *font* yet, which might seem a peculiar omission in a section about styles. Fact is, in Scrivener fonts---and font size for that matter---can be treated as separate from styles. Most of our built-in styles in fact do not mess with fonts at all, leaving that part of the equation up to you. They might change the *size* of the text, or how much space falls around it, but font can be left alone.

It is ...

The Styles Panel

MISSING_IMAGE:/path/to/gfx/blank_styles.jpg

The stock starting kit provided to you in every new project---including those upgraded from older projects.

The [styles panel](#blank_styles) is a convenient floating tool that can be used to apply styles to your text as you write, inform you of which styles are applied to the text you are working on and manage the styles as you go. Open this panel using the Format//Styles//Show Styles Panel (<$custom:shortcut>).

1. In the upper portion of the pane ...

Styles for Authors Using Markup

Scrivener has always been a tool that contains methods for those who work using markup systems, such as Markdown (and its variants MultiMarkdown and Pandoc), XML, HTML, LaTeX, DocBook and so forth. Of particular use in technical writing, Scrivener's style feature has been carefully designed to not only provide a traditional look and feel for those coming from word processors, but a powerful platform for defining ad hoc semantic types into the editor and then exporting those types into meaningful...

Styles That Do Nothing

Styles do not necessarily have to perform a formatting function in Scrivener. When compiled they can be removed conditionally, used to pass through instructions to the output format (raw HTML to ePub for example) and a few other tasks---but even beyond that they can simply do nothing at all and leave the text in a state where your readers will never even know it was tagged in the first place.

Consider that marking a text with a named style is a way of tagging text with meaning. You can use form...

Applying Styles

While writing, whether you come across a phrase that needs to be styled or you are preparing to write a phrase is a certain style, your usage of the tools will be similar---and familiar from how you might something simpler like changing the font size: you can either do so while typing, changing the way you type at the cursor from that point forward---or you can select some text and only apply those changes within the selected range of text.

How text is selected will have an impact on how styles...

Creating New Styles

Creating a new style is done by first formatting text in an editor (use dummy text if you do not have an example yet) using the standard formatting tools. Next, select the text (or merely position the cursor within the paragraph for paragraph styles) and then using one of the following methods to create a new style from it:

• The Format//Style//New Style From Selection... menu command.

• Click the AddButton button in the footer area of the style panel.

MISSING_IMAGE:/path/to/gfx/styles-add_n...

Redefine a Style

Modifying a style follows much the same procedure that creating a new one does. Text is formatted the way you would like the style to look (use dummy text if you do not have an example yet) using the standard formatting tools. Select the text (or merely position the cursor within the paragraph for paragraph styles) and then using one of the following methods to update an existing style:

• Use the Format//Style//Redefine Style From Selection// submenu to select the style you wish to overwrite.

...

Deleting a Style

Deleting a style can be done at any time by using the Format//Style//Delete Style// submenu. This command cannot be undone, but since it does not actually remove formatting from the text, if you do accidentally delete an important style you can re-create it by finding an example in your text, and creating a new one from scratch from its formatting.

Removing Styles from Text

Removing styles from existing text is very similar to what you would do when you are done typing in a particular styled range. The Format//Style//No Style menu command and its shortcut, <$custom:shortcut>, also strips out the style from the selected text or the paragraph.

• For character styles, you must always select the entire range of text you wish to remove the style from (just like how you would need to select an entire range of italic text to remove italics from it). If you use this comm...

Selecting and Searching for Styles

Marking text as styled is useful for many reasons, chief among them the ability to locate bits of text that have been tagged under a particular style. There is of course great appeal in easily walking through every figure caption in your dissertation or every block quote in a biography.

The styles panel itself has several of these tools gathered together into one place, by either right-clicking on a style and using the "Select All Text with Paragraph Style" command (which selects all ranges of ...

Copying and Pasting Styled Text

When working within the confines of one project, the matter of copying and pasting styled text is of so little consequence it hardly bears mention. It will happen, and you don't have to worry about styles getting lost between individual chunks of text.

What will require more attention to detail is when copying text *between projects*. The first thing to know about this process is that Scrivener will use name matching, not formatting, to look for style assignments within the same type (paragraph...

Importing from Other Word Processors

In general, importing documents from other word processors that have stylesheets will follow the same rules as described for copying data between Scrivener projects. The software will be looking for styles by their names, and thus you will need to have styles already created in the project's stylesheet by those names in order for them to import.

Not every document format may have the same results. If you find some styles are not importing as expected, try another format like RTF, ODT or DOCX.

Resizing Linked Images

Just as with embedded graphics, you can [adjust the display size of the image][Resizing Inline Images and Naming Them]. It is important to know that doing so will alter the original image's meta-data on the disk. The image will not have its pixels touched, but its print size information will be altered. If it is important to you that Scrivener not adjust the original files then do not use the resize tool in the editor, or consider using [image placeholder tags], where sizes can be specified as c...

Updating the Image from the Disk

For increased performance, Scrivener uses a cached version of your image when you first view it (or initially link to it) within a session. Whenever you re-open the project, this thumbnail will be updated with the current image on the disk automatically. However if you have updated an image on the disk and wish to see the results in your editor without reloading the project, right-click on the image and select the "Reload from Original Image" menu command.

This will also reset Scrivener's recor...

Renaming an image on the disk

You can of course freely rename images whenever and however you like, but you will find that upon reloading the project at a future point, the links will have broken. A technique for safely renaming an image name while preserving the link is to do so from within Scrivener:

1. Double-click the linked image to edit it.

2. Click the Change... button to bring up the file chooser.

3. Right-click on the name of the image (which will be selected automatically for you) and select the "Rename" option...

Utilising Links on Multiple Computers

Those familiar with the use of linked resources will already know that using links means that the position of those external resources must remain stable, in order for the host program (Scrivener in this case) to maintain a connection with them. If the files are moved or renamed, the link breaks and you will need to manually update them. This means that in most cases, links will only work on one machine, since the full path name of a file tends to vary, given that it includes the name of the com...

Fixing Broken Links

If the name or position of the image changes on the disk then the link to it in the editor can become broken. A broken image will fall-back to a warning message, printed in red highlighted text, with a special token identifying it as an image link, and the expected path to the image printed following:

MISSING_IMAGE:/path/to/image.jpg

The simplicity of this system means that if you fix the path to the image right in the text editor and the reload the project it will link back up. This also mea...

Images Linked to Binder Items

You may at times wish to use linked images to keep your text files trim rather than bloated with large files---but at the same time not have any need for the advantages using the file system gives you, and would prefer not to have to deal with the disadvantages, such as fixing broken links or having to contend with issues between synced systems across multiple platforms.

Linking to images in your binder is the solution to this problem. The graphic is not placed into your text directly, keeping ...

Image Identification

NOTE//WINDOWS// this will no doubt need some heavy editing once there is something to test on Windows. The image must be specified either by its imported name, as displayed in the binder, or by a valid system path to the image's location on your computer. Path names can be relative to the location of the Scrivener project, so if the graphics and the project are stored in the same folder, you would only need to declare the path as 'image_name.png' for it to work. You can also use the UNIX shortc...

Specifying Image Width and Height

The width and height of the image is an optional value, declared in points. If you have already sized the graphics correctly in accordance with your printer's specifications and output quality, then you will not need (or indeed want) to change the image size using Scrivener. However if you are not concerned with pre-sizing the images and just want to let Scrivener handle them for you, you can specify the width and height of the image in the placeholder tag, to instruct the compiler to resize it ...

Tips for Usage

Here are some ideas for how this feature can be used, as well as some handy tips for common uses.

• *Using Replacements to Change Images*: use of [replacements in the compiler][compile - replacements] will be evaluated prior to any images being included. That means you could use the feature to scan for the placeholder tag and remove it from the document, or perhaps change the path of the image to something else, which could be useful if you have two different groups of images, one optimised fo...

Handling Print-Ready Images

General tips for how to handle large images, and when not to try and handle them in the editor itself.

Images and Compiling to Markup

When using Web Page (HTML), or any of the MultiMarkdown and Pandoc compile formats, inline images (and linked images for that matter) will be converted appropriate syntax in the text and exported into the compile folder along with the text file itself. For formats that end up combining the source files into a bundled format like WebArchive or DOCX (via Pandoc), these intermediate files will be handled in temporary folders and won't appear in your output folder.

Renaming Snapshots

You can easily rename snapshots right in the Snapshot Manager. Double-click on the name of the snapshot, or press Esc to toggle editing mode. When you have finished editing the name, click elsewhere to confirm or press !Return.

Comparing and Rolling Back Changes

All of the capabilities available to you in the Snapshots tab of the inspector are in the manager as well, along the footer area of the snapshot content viewer itself. For documentation on how to use these specific features and settings, refer to the following:

• [Rolling the Text Back]: for setting the selected snapshot to be the text used for the main item in the binder.

• [Comparing Changes with Main Text]: for comparing two snapshots together, or one snapshot with the current state of the...

Searching for Snapshots

Above the snapshot list sidebar is a search tool that you can use to quickly locate snapshots by their snapshot name, the name of the binder item they are associated with or even by fragments of text within the snapshot itself. The search tool is fairly simple, and has a few rules and capabilities to be aware of:

• The mode of this form of search will always be "exact phrase", meaning the text you type in must be found in the order you type it in, case-insensitive.

• You do not need to speci...

Finding Where Snapshots Came From

If you locate a snapshot you are interested in, but aren't sure where its parent item came from in the binder:

1. Select either the snapshot in question or its associated parent in the sidebar.

2. Click the GearMenu button in the sidebar footer.

3. Select the "Reveal in Binder" option, or use the standard <$custom:shortcut> shortcut.

The result of this behaviour is identical to how "Reveal in Binder" works in general, though leaving the project window in the background---meaning if it is n...

Exporting Snapshots to Files

To save your snapshots as individual files to the disk:

1. Select all of the snapshots you wish to export using the sidebar.

2. Click the GearMenu button in the sidebar footer.

3. Select the "Export Snapshots..." command.

4. If more than one snapshot has been chosen, you will be asked for the name of the folder you would like to insert them within, and the location for where that folder should be saved.

Otherwise, you will be asked to name the snapshot itself that you selected.

5. Choose ...

Deleting Snapshots with the Manager

In addition to deleting individual snapshots (which you can also do right in the inspector), one very useful capability of the snapshot manager is the ability to purge many snapshots from across multiple documents at once. This becomes particularly powerful when combined with searching---for example locating and deleting all snapshots from a year ago or earlier.

1. To select multiple snapshots, you can use the traditional CmdCtrl and Shift keys to add or remove from the selection individually ...

Tables and Lists Don't Mix

Although you can create tables and bulleted lists inside annotations and footnotes in Scrivener, they are not supported inside annotations and footnotes in the RTF, RTFD and Word exporter. This means that if you place tables or bulleted lists inside annotations or footnotes in Scrivener, when you export these elements will be stripped out.

Changing Annotation Colours

Inline annotations can have their colours changed independently. This makes for an easy way to create "types" of notes that you can spot at a glance. High priority notes might use bright red, while deleted text could use light grey. To change the colour of annotation:

1. Placing the cursor anywhere within the annotation you wish to colour, *or* select only a portion of the annotation to effectively split it into two adjacent differently coloured annotations.

2. Use the Format//Color... menu c...

Want to get back to default red?

In the direct-sale version of Scrivener (sorry, the Mac App Store doesn't allow software to install colour palettes), bring up the system color tool with Format//Color... and click on the "Color Palettes" tab. From the dropdown menu at the top, select the "Scrivener" set. You will find an "Red Annotation" swatch in this palette.

Footnote Highlight Style

If you find the default appearance of footnotes too heavy for the quantity of footnotes in use, there is an alternate way of working with them that will be more familiar to those accustomed to how word processors typeset in the manner they will be printed. This method will place a simple footnote marker [after the current selection, or current word, rather than highlighting the relevant phrase](#footnotes-marker_style).

MISSING_IMAGE:/path/to/gfx/footnotes-marker_style.jpg

Footnote markers dema...

Compiled Footnote Numbering

MISSING_IMAGE:/path/to/gfx/inspector-footnote_numbering.jpg

Footnote numbering in the inspector is based upon the previous compiled order.

Since footnotes can be scattered across hundreds of files throughout the draft, Scrivener does not number footnotes as you create them. Instead, they will counted as the software compiles your draft, and you can choose to have these numbers displayed in the inspector list, as depicted in [](#inspector-footnote_numbering).

To enable footnote numbering, use t...

Font Tab

The Font tab provides options for setting the character appearance for the selected element, as follows:

Font

: Allows you to set the font family for the current element, and the size of the font (in points) to the right. Scrivener does not use the font to identify elements, so you can change the font here without messing up Scrivener's recognition of script elements. This also holds true for font changes made in the editor.

: Scrivener comes with [Courier Prime] installed within it, and will...

Paragraph Tab

The paragraph tab provides paragraph formatting for the selected element:

Alignment

: Sets the current paragraph alignment (left, centred, right or justified).

Spacing

: Sets the line-height multiplier (single, 1.2, 1.5 or double). Some script formats (such as Screenplay) will have a Fixed Line Height setting, behind the Options button in the lower right-hand corner of this pane. You will need to set the fixed line height to 0pt to disable that feature, before seeing any effect on this setting...

Tab/Return Tab

The Tab/Return pane allows you to control the tab and return behaviour for the selected element; that is, it lets you specify what happens when you hit the tab or return keys, and so thus can be used to aid in the flow of writing. If you are creating a scripting environment from scratch, you might wish to save this step for last, since you will need to reference other elements (which may not exist while you are going through the list, initially).

On return

: Sets which element formatting the te...

Auto-Complete Tab

The Auto-Complete tab allows you to set a custom list of words that will appear for auto-completion while typing in the current element.

Use the AddButton and DelButton buttons below the list to add or remove new words to the auto-complete list, and double-click on words to edit them. By default, these phrases will be suggested automatically while you type, and the first letters typed in will match a phrase in this list, you will be presented with the auto-complete list. Note that the auto-comp...

(Mac features)

In the Project Targets panel, you will see a Twitter icon, where you can share your progress. Scrivener will automatically generate a short sentence for you, based on any activity (or lack thereof) that has happened during the session. If you write 800 words, then it will select a phrase extolling how much you've written. If you've subtracted 800 words it will assume you have been editing that day. If there is no change, it will assume you have just started working for the day. By default it wil...

Project Targets Options

Click the Options... button in the Project Targets panel to configure how these progress bars are calculated, and what Scrivener should do if you meet your goals. NOTE//WINDOWS// these are likely both Mac-only options, but I'm leaving them there for now so as to ask about them later. There are a couple of common options available at the bottom of the pane, below the tabbed areas:

Show target notifications

: System notifications will be posted when the status of your targets change. For example...

Tracking Goals for Groups

When using Scrivenings mode, a progress bar will be shown if any documents in the session have a goal set. In this mode the progress bar becomes a "total progress" tracker, adding all of the goals and various settings together and using the grand total in the editor against that goal. This can have unintended results if, for example, you set a goal of 200 words for one document but then form a session including it and other files for a total of 1,200 words. It would be better to set goals for ea...

Project Statistics Options

RSRCH// see if the Statistics compile option pane has any bearing on this section. I think it just impacts tokens. To access options for how project and selection statistics are calculated, click the "Options" tab in the window. The first group of options, under the "Compiled Statistics Options" heading, impact how the statistics in the first tab of this pane are calculated:

Count current compile group only

: Only calculates off of documents that have been chosen in the Content pane of the Com...

Referencing Images with Document Links

There may be cases where you might *not* want the image to be in the editor, or maybe you prefer using text syntax to refer to images rather than working around them as visual objects in your text---but you would still like to take advantage of the automation that produces images on output into a folder. While you could use the [image placeholder tag that is available to rich text authors][Image Placeholder Tags], you might as well use native Markdown for its extended syntax:

1. Write out the ...

Cross-referencing Images

The method Scrivener uses to generate image syntax is conducive to MultiMarkdown cross-referencing. At the time of this writing, Pandoc does not have an automatic method for cross-referencing images. You would need to use the referenced image technique described in the previous section to create the necessary Pandoc syntax to create an HTML ID that can be linked to. It will use the image filename for the Markdown reference handle (or ID), which in turn can be used as an anchor link. All figures...

Captions

When images fall upon their own line, you can supply a caption to them using one of the following techniques:

• Place the caption within straight (not typographic) double-quotes, or in matched square brackets, on the same line after the image, separating the image from the caption text with a space.

• Alternatively, place the square bracketed caption on the line *directly* following or preceding the graphic.

• Use a designed caption style on the line directly preceding or following the image...

List Support

The compiler can generate Markdown style bullet and enumeration lists based on lists found in the text, when the option is applied to do so.

MISSING_IMAGE:/path/to/gfx/markdown-list_examples.jpg

Example list formatting converted to Markdown text (invisible characters shown for clarity).

• All list types found in Scrivener will be expressed as either bullets (using asterisks) or enumeration (using digit + dot formation). For example, a list type in Scrivener using "a. b. c." formatting will ge...

Table Support

Table conversion is relatively simple, and like most aspects of conversion to Markdown, disregards the particulars of formatting and converts the basic structural data expressed by the table. For example, in [](#markdown-tables-merging_cells), we see a table with a grey fill being used to indicate the header row. It is a header row merely by being the first row, and requires no styling to become that way in the output, nor will the styling have any bearing. There are three exceptions where table...

Post-Processing and Custom Formats

One big advantage of the plain "MultiMarkdown" approach We call the compile file type "MultiMarkdown" for simplicity, but it's also capable of producing Pandoc format, and as you will shortly see from this section, literally anything that can be constructed out of plain-text. is its post-processing option. This won't be something you find in the compile overview screen, but instead when modifying or creating your own compile formats. Refer to [the Processing compile format pane][compile - proce...

Where is it?

If you do not have a !LaTeX distribution with *pdflatex* installed on your computer in an executable path, then this option will not appear in the compile format dropdown. Scrivener looks for pdflatex in `/Library/TeX/texbin` and `/usr/texbin`, and if it isn't found in either of those places, it will use the *which* command-line tool to try and locate a copy in the executable path. If nothing is found in any of those places, the file type will be removed as a compile option.

Compile Group Options

Depending upon the type of choice made with the Compile dropdown menu, secondary options may appear at the top of the content list.

Two additional settings will be provided whenever an individual container from the "Draft" folder is selected:

1. Treat compile group as complete manuscript: ordinarily when a portion of the draft folder is selected for compile, counter numbering will be displayed as though the rest of the manuscript existed; chapter 13 will remain 13. When this option is enabled...

Content Item List

The item list is the large table in the middle, marked (c) in [](#compile-settings-contents_tab), displaying the contents of the current compile group. In the provided example the "Draft" folder has been selected, and so the entire Draft contents are revealed in the list below it. The items in this list will be indented just as they are in the binder, hierarchically.

There are three columns within the table. It is usually a good idea to initially scan these columns to make sure everything will ...

Filtering

Filtering makes it possible to supply certain criteria by which the compile contents list will be modified. For example you can have it only include those items which have a "Red" label set to them, or conversely, remove all items from the list marked with "Red". Start by clicking the filter button, marked (b) in [](#compile-settings-contents_tab), alongside the main Compile group dropdown.

MISSING_IMAGE:/path/to/gfx/compile-settings-filtering.jpg

The "Filter" button reveals options for further...

Front & Back Matter

The main matter (or body matter) is a publishing term for the core content of a book, from the first chapter to the last. Front and back matter are defined as the material preceding and following the main content of a book. Front matter (also known as preliminaries or just prelims) will typically include everything from the title page and copyright page to the preface and introductions. In print publishing, this often includes a different header and footer style, such as Roman numerals for the p...

Book and Author Information

Title

: If nothing has been provided in this field, the title will be taken from the name of project itself on the disk. Use this to set the formal title of your work; it will be used wherever the `\<$projecttitle>` placeholder has been typed in.

Abbreviated Title

: POST//WRAPPING Especially useful in headers, long titles often need to be shortened to fit in the header area, so you can optionally use the placeholder, `\<$abbr_projecttitle>`, to display a shortened version of it. If nothing is ...

Word Processing and Web Metadata

The RTF, RTFD, DOC, DOCX and ODT formats all support additional fields that can be saved into the properties of the file. For example, the information filled out in this area will appear in the document's File//Properties... command. You may need to consult guidelines for how they should be used if submitting documents to a central repository. Some of these fields may be used by search indexers to better categorise the documents among others.

When used with HTML files, the information supplied...

Ebook Metadata

The additional fields provided to eBooks will be inserted into appropriate book description fields, often available to e-readers to display in whatever manner they provide, and used to automatically sort the book within electronic catalogues. Most of the fields allow for freeform entry; you should consult with your publisher or distributor on best practices for using these fields.

Contributors

: As with the Authors field, each person's name should be separated with a semicolon. Amazon's Kindle...

Fountain and Markdown-based Metadata

The Metadata pane for Fountain and the Markdown-based file types provides a front-end to the preliminary metadata block found at the top of these kinds of files. Pandoc format uses a [YAML] block, which for the purposes used in Scrivener matches the format used in MultiMarkdown and Fountain's metadata block. Each line in the block is prefaced by a key, such as "Title", followed by a colon, some whitespace and the value.

MISSING_IMAGE:/path/to/gfx/compile-markdown-metadata.jpg

The Fountain and M...

Common Settings

There are a few options in this tab that pertain to all types of documents that can be produced with Scrivener, or are used by a large majority of them.

Rich Text Options

Unless otherwise noted, in this case, "rich text" refers to not only the word processing document formats (such as RTF, DOCX and ODT), but eBooks, HTML, PDF and Print.

Markup Options

These settings pertain the Markdown-based document types at the bottom of the Compile for dropdown. Pandoc to ePub also supports some options described in the next section.

Ebook & HTML Options

With the exception of the first option in the following list, these settings are only available for eBooks.

Scriptwriting Options

The Fountain (.fountain) and Final Draft (FDX) formats offer some unique capabilities that various components of your project could be used for.

Creating Replacements

To create a new replacement:

1. Click the AddButton button in the lower right-hand corner of the table, or click into the table and use the !Return key to create a new row.

2. Type in the text you want to have changed when compiling.

3. Press Tab or click into the With field and type in what the text should be changed to.

4. Press Esc or click elsewhere to commit your changes, and tick any relevant checkboxes to the right of the text columns.

Looking for what you cannot see?

If you need to...

Removing and Disabling Replacements

To delete a replacement permanently (if you merely wish to disable the replacement, click the checkbox in the leftmost column of the corresponding row):

1. Select the row you wish to delete by clicking on it in the table, or using the arrow keys on your keyboard.

2. Click the DelButton button in the lower right-hand corner, or press the !Delete key.

Modifying Replacement Order

The order of replacements in the list can be significant as they will be evaluated one after the other from the top of the list to the bottom. This means you can use use earlier replacements in your subsequent replacements, if you are feeling brave. Thus you can change the order of replacements by dragging and dropping them in the table.

Copying Replacements Between Projects

You can copy and paste selected replacements (use the Shift and CmdCtrl keys to select with the mouse or keyboard arrows, or CmdCtrl-A to select them all) between projects using the ordinary methods for copy and paste. Just make sure to click into the replacements table so that when you paste Scrivener knows where you meant to paste the replacements.

If both projects have their compile overviews open at once and you have enough screen space to do so, you can also drag and drop between tables.

Advanced Replacements Usage

Replacements can also take a special placeholder (or wildcard), `$@` which will be used to match everything between the rest of what you type in the search field. The matching text will be temporarily stored and pasted into the With field if you use the same wildcard placeholder there. This wildcard only works when surrounded by text to match with, it cannot be reliably used at the start or end of the Replace field, though the placeholder can be positioned anywhere you like in the With field, e...

Cover image

Click the dropdown menu below this label to select an image from your project and designate it as the cover image. The image you choose will be displayed in the preview area below.

If you want to copy your cover image to another project you can drag it from the preview area into that project's binder, where you can then be assigned as the cover image in its compile settings.

Add HTML cover page

Some ePub book readers will not discover an image that has been marked as a cover graphic in the book's metadata. For these readers you will need a literal page in your book that contains the graphic, like a sort of title page. They will typically look for the first graphic in the book and use that for the thumbnail, which this option will enable. If you are unsure of whether the service or reader you will be working with supports regular covers, it will be safest to turn this option on.

Cover page title

This option is only relevant to the ePub file types, and if the previous option has been enabled. You should not supply the name of your book here. This is what will be used in the table of contents internally, to identify the cover page. The standard "Cover" has been provided as a default.

Tips for Good Covers

Graphics for cover art should be in a standard RGB raster format, such as JPEG, and not a vector format, such as EPS, nor CMYK colour space which is designed for printing. If you are unsure of how to make these adjustments to the files you have been provided with, you should contact your graphic designer with these specifications so that they can deliver a quality version to you at the correct size, and let them know which devices they should design for (iPad, etc.).

In particular, watch out fo...

SVG

This is an advanced feature for ePub books which will allow you to insert SVG code which can be used in conjunction with, or instead of, a bitmap image. If you have been provided with SVG artwork code by a designer, or have created one yourself, use the SVG button to access the sheet. The text area labelled, "SVG Code" is where you will paste the vector format code.

You will need to manually specify a default view box size. Get this information from your designer, the graphics program you used ...

Generate HTML table of contents

The compiler can automatically generate a table of contents into the text of the book itself, typically somewhere near the front of the book. It is a good idea to provide this in addition to the menu-based navigation that most book readers now support, as older devices may lack the latter, leaving your readers without any way of getting around in the book. If you know your book will only be read on modern devices and want to clean up the front matter a bit, it is safe to disable this option.

If...

Contents Depth

Applicable to the Pandoc ePub file type, this setting refers to the *heading depth* in the HTML itself, rather than Scrivener hierarchical representation of depth in the binder, or by the [internal section breaks that cut one file from the next]. A single flat file might have four levels of heading depth within it, and all of those up to the number specified in this field will be displayed in the ToC.

Center body text of HTML table of contents

Centres all of the titles rather than left aligning them.

Use flat table of contents

This only impacts the internal menu-driven contents, not the HTML formatted ToC. By default, the listing will be nested according to the depth of the items in the binder, which might either cause navigation to be presented as an indented list, or involve the reader drilling down into subsections, depending on the reader. For shorter works, it may be desirable to have all points of navigation in the book visible at once and in a simple flat list. Enable this option to achieve that look.

Bold top-level items

Within the HTML contents page, those items located at the top of the current compile group will be emboldened. If the outline has several layers of depth, this can be a good way of visually distinguishing the major sections of the work.

Omit "landmark" guides

By default, Scrivener will use modern referencing for various landmarks in the ebook, such as the contents, cover image and the starting position that the reader will open a newly acquired book to. In some cases, such as when displayed using Amazon's "Look Inside" feature, these markers will become visible. Disabling this option will use the older markers for these sections.

Table of contents title

Determines the title readers will see for the generated HTML contents, as well as what it will be referred to in navigational menus of some readers and eBook software. If you have created your own table of contents page using the method described in [Contents in eBooks], you will need to ensure that the name of the item in the binder used for that custom ToC matches what you provide here.

Adding New Layouts

To create a new layout:

1. Select the layout that most closely resembles the new one you'd like to create. You'll be able to change everything about it, but if it is just a variation on a chapter heading it would be easiest to start from another chapter heading layout.

2. Click the AddButton button in the upper right-hand corner.

3. Give the new layout a name and click elsewhere to confirm your change.

Renaming and Managing Layouts

Changing their order: the order of layouts isn't of great significance, but they will be listed in the order they appear within this list, when assigning types to layouts in the compile overview screen. If you want to change their order, just drag and drop.

To rename a layout: double-click on its name in the "Layout Name" column. This will not affect any projects using that layout for their types, they will automatically adjust to using the new name.

Deleting a Layout

To remove a layout you no longer want in the format, select the layout from the listing and click the DelButton button. This action cannot be undone, but you can of course close the format editor without saving changes by clicking the Cancel button along the bottom.

Layout Content Columns

In all cases, these checkboxes merely add or remove the content itself from the layout. The formatting of that content, embellishment of it (such as adding decimal numbering to the title) and so forth are done using the tabbed settings below this list.

Title

: Prints the binder title of each item assigned to use this layout. The title will typically be placed on a line of its own at the very top of the section, much like a heading or chapter break would be. This checkbox is only used to bring t...

Duplicating Settings Between Layouts

With so many options available in regards to the specific Layout itself it would be useful to have management tools for copying these settings from one layout to another. Say you've set up a meticulously designed layout for chapter breaks, and realise that with the exception of the title prefix, you want everything else to be applied to a variation use for interludes. You can use the following techniques for copying some or all settings (and remember that when creating new layouts you can always...

Changing How a Layout Works

When you select a Layout in the list, its settings will be loaded into the tabbed configuration area below (showing a preview by default). You can thus switch between layouts and easily compare settings between them.

Include placeholder titles for untitled items

Those binder items that have been left untitled can optionally use the adaptive name generated from their content or synopses, as they are shown in the binder and outliner. The default behaviour is for these items to never show titles, even if they are assigned to a section layout that chiefly exists to generate a title.

Do not add prefix or suffix to placeholder titles

When untitled documents are encountered, if the section layout they are assigned to generates a generic title (such as a chapter number), then that part of the title will still be used. Thus an untitled document may still have a structural presence in the final result. If you would prefer untitled elements be entirely anonymous and not contribute to the structure, then enable this option.

Insert subtitles between text elements

If more than one type of content (excluding the Title) is included for a layout, then Scrivener will insert subtitles between those elements to help set them apart. These titles can be formatted like everything else in the formatting editor below. You only need to edit the formatting of one subtitle to impact them all. Disable this option if you would prefer to a seamless approach.

Place notes after main text

The default is to place any Inspector notes above the main text for the item being compiled. When checked, notes will be placed below the main text area instead.

Add closing hashes to titles

This option only pertains to the Markdown-based formats. When adding formal titles to the document, Scrivener will enclose the title in hashes:

### This is a Third Level Document ###

Disable this option to use the following format:

### This is a Third Level Document

Using Styles with Layouts

The Styles button on the far left of the Format Bar will refer to styles provided by the *format itself*, via the [Styles format pane][Styles], not any styles in the project. Remember, Compile Formats are self-contained and know nothing about the projects they are applied to.

They also function a little differently to styles in the main editor in that if you modify the formatting of the text at all after applying a style, the assignment to that style will be removed, and it will no longer updat...

Overriding Text and Notes Formatting

The checkbox by the same name along the bottom of the preview area will toggle whether or not you can format the main text element in the preview area (assuming you are including either Text or Notes via the checkboxes in the layout list above). There are a few important things to be aware of with this feature:

• Text that is styled in the main text editor will *ignore* any settings made here. Styles in Scrivener are a way of declaring a range of text as special, or anything other than body te...

Plain-text

You may be wondering if you can skip this when working with plain-text. Naturally in most cases if you were to set the title to 24pt bold it will not do anything to the compiled document. There are a few notable exceptions that could be of use to you:

• If converting paragraph and indent formatting to whitespace [in the Transformations format pane][Transformations].

• Where styles are applied to text in the preview area and those styles are set to modify the text somehow, in [the Styles forma...

ePub 3 and KF8 (Mobi)

When working with either of these modern and fully semantic file types as your output, the "Formatting" tab will be a little different. Instead of providing full rich text formatting controls, you will only be able to apply styles to text (this will be most useful when assigning styles to [HTML Elements][compile - html elements]), and overall formatting should be done in the [CSS compile format pane][compile - css].

Insert title as run-in head

When the title (or title suffix) is immediately followed by a standard text block (Main text, Notes, or Synopsis), it will be merged into the first paragraph of that text. In the case of using a suffix on its own line, the suffix will be moved into the first paragraph, not the prefix or title.

When using run-in headings, the font and character attributes of the title will be used to style the title, but its ruler settings will be ignored in favour of the Main Text settings.

This option will no...

Title Case

This setting, along with the Case settings that appear below each of the prefix and suffix text boxes, will dynamically adjust the letter case of these title elements. The following options are available to most file types:

* *Normal*: letter case will not be adjusted. However the title elements were typed in will be passed through.

* *Uppercase*: all letters will be converted to UPPERCASE.

* *Small Caps*: this uses faux small caps, by converting all letters to uppercase and then changing th...

Title Prefix

Anything typed into this box will be printed directly before either the binder title, or the suffix if the title has been omitted. If you intend to use this to insert the first part of a multi-line title, insert at least one carriage return after the boilerplate text in this box.

Title Suffix

The contents of this box will be printed directly after the binder title or the prefix. Consequently if you intend for this to display information on a line below the main title, insert at least one carriage return prior to typing anything in.

Place prefix/suffix inside hashes

Available only to the Markdown-based file types. The title prefix and suffix will ordinarily be placed within the hash marks that Scrivener generates to indicate title depth---thus as part of the heading itself. If you prefer, you can disable the Place prefix/suffix inside hashes options to [allow text entry outside of the header line itself](#compile-section_layouts-mmd_prefix_and_suffix). Prefix and suffix placement remains literal and directly adjacent to the title element. Thus for proper fo...

(MMD Prefix and Suffix)

MISSING_IMAGE:/path/to/gfx/compile-section_layouts-mmd_prefix_and_suffix.jpg

The placement of the prefix and suffix around automatically generated hashes with them inside and outside, respectively.

Number of hashes

Available only to the Markdown-based file types. Adjusts the number of hashes to use for titles in this section layout. This can be a way of coercing a layout to always print a heading of a certain depth no matter its literal depth in the binder outline. A "Part" section might always want to use a setting of "1", for example. By default, the "By Level" setting inserts a number of hashes indicating the depth of the item in the outline, regardless of its layout type.

Setting this to "0" will remo...

Pad top of page with *n* blank lines

Adds the defined quantity of empty lines above the title and section prefix. This will have the effect of pushing the title down into the page and leave an area at the top blank. Since the setting uses lines this can be used with any file type. This option will be previewed in the section layout's tile, in the compile overview screen.

Even though this option is available to the Markdown-based formats, it should be noted that these systems generally disregard blank lines and they will appear to ...

Number of opening words to make uppercase

If your formatting requirements are such that the first few words of the paragraph following a title need to be uppercase, then specify how many words should be set to uppercase with this setting.

Use small caps

You can also opt to use faked small-caps instead of all upper case, using the checkbox below this setting. This only works with file types that can use font sizes.

Uppercase even when section is not after a page break

This is the one setting that will trigger even if the section does not generate a page break. Use this if you need to capitalise words following a regular heading or soft break, like a divider or empty line.

Add "first-letter" span style to the first letter

Available to ePub 3 and KF8 Mobi, this wraps the very first letter of the section in a span with the "first-letter" class assigned to it. This can be used to style drop-caps or other visual effects. You can either create the CSS yourself in [the CSS compile format pane][compile - css], or you can create a style called "First Letter" and use the WYSIWYG formatting in [the Styles pane][Styles]. For true drop-caps you will need to use CSS directly as Scrivener itself cannot create floating boxes.

Setting which page a section falls on

Using the next two options (only available to print and PDF), you can set up common typesetting techniques, such as setting a "part" page to be displayed all by itself on the recto side, with the chapter page following it on the recto side as well and a blank page in between them to do so.

Always start section on

The new section can be forced to always start on the verso (left) or recto (right) side of the book. This will in some cases cause an empty page to be inserted, in order to keep the chapter on the chosen side.

Start next section on

If the *following* chunk of text also generates a page break, this setting will control how it behaves if it otherwise doesn't use the prior setting itself.

Paragraph first line indents

Utilises the common typesetting practice of discarding the first-line indent for any paragraph following a header and/or section break. The calculation for this can be tuned with a set of options below the main checkbox. This adjustment is handled globally, rather than per specific section type in the ePub 3 and KF8 Mobi formats, via [the Text Layout compile format pane][compile - text layout - ebooks]. If you require a more granular approach, consider providing the section layout a CSS class na...

Include in RTF bookmarks

This option is used by all of the word processing formats, which are derived from RTF initially. It is enabled by default for all section layouts, and thus those items not using the "as-is" assignment in your binder will get an RTF bookmark.

These will create handy navigational references throughout the document in word processors, and is also used to cross-reference document links in Scrivener. It may not always be desirable to have bookmarks at every level of your outline, especially if you u...

CSS class name

This and the following setting are available to ePub 3 and KF8 Mobi. When a class name (it is up to you to provide a valid class identifier here) is assigned to a section layout, a `

Hide section in e-book

Available to ePub 3 alone. This setting will remove the documents that use this Layout from all forms of navigation in the ebook, including next/prev chapter functions, the internal table of contents, and the automatically generated HTML contents if applicable. It will be referred to as a "non-linear section" in eBook editing programs.

Support for this specification may vary between readers. Some may allow the reader to navigate through these "hidden" sections, but by and large it will not be p...

Delete text of this style

All text that has been associated with this style will be removed from the output. A practical example of this feature is in use with this user manual, where specific phrases of text relating to macOS or Windows alone can be selectively omitted depending upon which format it has been compiled with.

Treat as raw markup

This option is available to all file types that make use of or are capable of generating markup: TXT, HTML, the eBook formats and the Markdown-based file types. In all cases the effect of this option is to fully suppress any compile behaviours that might modify the text as you typed it in, allowing you to inject raw markup as intended to the final output.

To provide a very simple example, if you manually type in `` into your editor it would end up as visible text when you comp...

Flatten first indent

This and the following two settings are available to print, PDF, the word processing formats, HTML, ePub 2 and legacy Mobi. Both ePub 3 and KF8 Mobi depend upon CSS for this level of behaviour adjustment.

The first paragraph within the assigned range of text will have any first-line indenting removed.

Looking to adjust indent settings globally?

These features are not intended to be used for handling large and dynamic amounts of text (such as all body text), but rather smaller ranges such as individual block quotes, monologue formatting and so on. For bulk indent management, you should use [the Section Layout: Settings tab][compile - section layouts - settings], and for ePub 3 and KF8, [the Text Layout pane][compile - text layout].

Single paragraphs only

The first-line indent will only be removed from one line uses of this style.

Flatten next indent

The paragraph of text *following* the paragraph using this style will have its indent removed. A common use case for an ability like this would be to suppress the indent of the paragraph of text following a figure caption, meaning the "Caption" style itself would be responsible for declaring that rule.

Prefix/Suffix

The start of the styled range will have the text of the Prefix field added to it---styled in the same fashion as the text that generated it. Likewise the Suffix will be added to the very end of the assigned range of text. If the range spans multiple paragraphs, there will only be one prefix and suffix at the very beginning and end of the assignment. This (and the following) setting can be useful for a number of different applications:

* In plain-text technical formats, such as XML, this can es...

Paragraph prefix/suffix

Operating in a similar fashion to the previous set of options, this setting only applies to Paragraph and Paragraph+Character styles, and it will insert a prefix or suffix around each line of text *within* a styled range.

To use HTML as an example, you could wrap an entire block quote in `

` and `

` and `

Override name

Available to all of the word processing formats, except RTFD. For cases where the style name used by compile settings (which in turn is how it will be worked with in the project itself) must be presented differently in the output document, use this field to completely overwrite the visible name of the style. For example if you are working with a Word template that expects "Blockquote" instead of Scrivener's "Block Quote", you could override its name to that, here.

CSS class name

Available to ePub 3 and KF8 Mobi. This will be of considerable use if you intend to write your own CSS. The ranges of text you assign with a style will be classed (either as `p` or `span` elements accordingly) with the name you provide here. If you do not provide a class name, Scrivener will attempt to automatically generate one based upon the style's name.

It is up to you to select a valid CSS class name. If you type in invalid punctuation or uses spaces, then you will likely break your styles...

Include font family

For cases where you merely wish to adjust some aspects of the character formatting but leave the font family alone, enable this checkbox.

Include font size

Likewise, if the inherent font size should be left alone---either to be established by the compile format or the underlying text in the project---check this box.

Include styles information in exported file

Available to the word processing based formats (excluding RTFD), this option is enabled by default and will cause the stylesheet that is generated by combing both the underlying project's styles, and any styles added or modified by the compile format, to the exported document. This will greatly enhance the flexibility of your file after it has been compiled, and in some workflows will be a requirement for submission or collaboration.

Use centered column to restrict body text width

Instead of allow text to flow from one edge of the browser window to the other, this option will enable the common tactic of constraining the text column to a maximum width in the middle of the viewer.

Body text width

You can set the width of that column with this setting, in points.

Use 100% width for images wider than...

Determines the effective maximum width for images by leaving it up to the e-reader after the width you set (in points, not pixels). Images narrower than that size will use a fixed width no matter how wide the e-reader's display might be. Note that some readers might always display images a certain way regardless of your settings here, particularly if the image is wider than the display.

Include scriptwriting CSS

This setting is available to ePub 2 and legacy Mobi formats; if you need scriptwriting elements in your ePub 3 or KF8 Mobi book, refer to [the CSS compile format pane][compile-css]. If your eBook is composed of, or contains any script formatting, you should enable the "eBook contains script formatting" option. Scrivener will insert special formatting rules that match the script format settings you are using in that project, and typeset these elements appropriately.

In most cases, the default st...

Embed MathType equations as MathML

This is a default setting, and is only available, for ePub 3 and KF8 Mobi type books. Any MathType images found in the compiled text will be inserted into the eBook as a `$`\; element,\; conforming\; to\; the\; specifications\; for\; MathML\; syntax.\; You\; should\; test\; your\; intended\; target\; readers\; for\; compliance\; with\; this\; format.\; If\; they\; do\; not\; display\; MathML\; equations\; correctly,\; or\; satisfactorily,\; you\; might\; wish\; to\; turn\; this\; feature\; off\; and\; have\; Scrivener\; convert\; equations\; to\; raster\; images\; (PNG)\; for\; maximum\; ...$

Remove first line indents

Available to ePub 3 and KF8 Mobi. This is a global setting for setting the behaviour of first-line indents that follow different types of elements in the book. The effects of this setting are implemented in [the CSS compile format pane][compile - css], and can be further tweaked there if necessary:

* *From all paragraphs following other elements*: anything other than another a paragraph will cause the first-line indent to be removed. This uses the HTML definition of the `

` element, which ma...

Common Options

This list of options pertains to common settings and those that impact footnotes specifically (not endnotes). Given how these options are scattered around in different places depending on which file type you're currently working with, the listing of options will be in alphabetical order, rather than attempting to adhere to interface order.

Common Endnote Options

As with the previous section, the options here will be listed in alphabetical order.

Plain Text Endnotes

In plain text files, endnotes will be used by necessity as there are no pages to place end of page notes on. Footnote markers in the main text will be printed using a conventional square bracket to denote them, such as `[42]`.

Plain text endnotes can be gathered somewhere other than the end of the document, with the Endnotes placement setting. For the case of plain text, where these options refer to "page breaks", the meaning is where a page break *would be*, were the document compiled to a fil...

HTML and Legacy eBook Endnotes

By and large eBooks make use of endnotes, since they do not have literal pages to draw "footnotes" upon. Endnotes are typically handled as cross-references using hyperlinks to and from the note and original text. Scrivener will handle all of that wiring for you, and will use conventions that with some book readers will be used to present endnotes in popup bubbles when your readers tap or click on them

ePub 3 and KF8 Mobi Endnotes

The previous notes on how eBooks work with endnotes all apply to these more modern formats as well. The main difference is that Scrivener affords you additional formatting control when using them, through the use of compile format styles rather than a few hand-selected options.

Export Comments and Annotations as...

This dropdown menu is only available to the word processing file types.

* *Margin comments*: exports your notes into a format that most word processors will display as a margin comment or "speech balloon" style comment. For most workflows this will be the most desirable option, and it is the default.

* *Inline comments*: if comments are not showing up for you using the above option, this method will print them as inline text, and will cause even comments to use the Enclosing markers for annot...

Enclosing markers for annotations

Annotations will be enclosed in two markers that will be used to delineate them from the rest of the text. In conjunction with a plain-text system, you could modify these to conform to the target file type's commenting conventions. Someone who is publishing in HTML might for instance wish to use the open and close syntax for HTML comments.

Most of the built-in compile formats use square brackets to denote annotations. The "Basic MultiMarkdown" format will use CriticMarkup syntax: `{>>annotation...

Use format for comments

Available to plain-text as well as the Markdown-based format. When ticked, linked comments will be formatted using the following text field as a template. You can supply syntax to wrap around the content of the comment, and even refer to the hyperlinked text in the editor that has the comment highlight, [as well as make use of a few placeholder values for comments][Comment Syntax Placeholders].

A simple example would be for the generation of CriticMarkup syntax:

{==<$lnk>==}{>><$cmt><<}

A mo...

Markdown-Based Annotations

When using the MultiMarkdown and Pandoc compile formats, the name of this format panel will be changed to "Annotations", as it will only pertain to the formatting of inline annotations and comments. In addition to the relevant options documented in the prior section there is one exclusive option available to these file types:

Header & Footer margin

Designate the distance of the header from the top of the paper, and from the bottom of the paper for the footer. This distance does not take the margins into account, and should not exceed the margin size so as to avoid running headers or footers into the body text.

To disable this feature, set the distance to "0". The result will be to place the header or footer within the top or bottom inch (regardless of units used) of the paper.

Confine to printable area of page

With this option disabled, the non-printable area of the paper will be ignored, meaning you can place elements into that zone. This may be of use if you are intending to create a digital-only copy that will never be printed. When enabled, measurements will be adjusted to keep all text within the printer's ability to print it.

Different header and footer on first pages

Enables the "First Pages" header and footer configuration section in the second tab. "First pages" generally refers to front matter, and is how you would use for example lowercase Roman numerals for page numbering if need be. It can also be used for simply omitting headers and footers through the coversheet and title page of a manuscript, too.

Page numbers count first pages

This option will cause the page counter token to start counting the first pages, rather than skipping them, even if they do not display a page number. If you are using Roman numerals in the front matter, then regular numbering will begin where they left off. For example if there are four pages of front matter the page numbering would go from "IV" to "5", instead of from "IV" to "1", which would be more traditional.

Main body header and footer starts...

This setting defines what is meant by "first pages" elsewhere in the panel. You can choose to offset the alternate header & footer settings by a strict number of pages (for example, "2" to consider a coversheet and title page as separate from the main body), or have the starting point determined automatically, using the "After front matter" setting.

[Front matter is defined by the Front Matter dropdown in the project's compile contents settings][Front & Back Matter]. If the project does not hav...

Use facing pages

Enables the "Facing Pages" header and footer configuration section in the second tab. If your margin settings are asymmetrical, as illustrated in [](#compile-page_settings-facing_pages), this will also have the effect of mirroring those settings from one page to the next, creating a narrower inner or outer margin (in the sense of how both pages would look in an opened book side by side) as you require. If you require symmetrical margins, such as in PDFs meant for digital use only, make sure to k...

(facing pages example)

MISSING_IMAGE:/path/to/gfx/compile-page_settings-facing_pages.jpg

Margin settings, using the classic Van de Graaf Canon layout, as demonstrated in Scrivener's preview feature.

Different header and footer on pages following page breaks

Enables the "First Pages" header and footer configuration section in the second tab. This will allow for a different header and footer configuration on new pages---a common use here is to place the page number at the bottom of the page instead of at the top, to keep the chapter heading clean but still leave the page numbered.

Different header and footer for back matter

Enables the "Back Matter" header and footer configuration section in the second tab. All pages that have been inserted using [the Back Matter dropdown in the project's compile contents settings][Front & Back Matter] will use these settings instead of the main body settings.

No header on new pages following page breaks

When enabled, the header (not footer) will be disabled on any page following a page break. Most often this will be used to keep the title area for part and chapter breaks clean; a common typesetting technique, as shown in [](#compile-page_settings-no_header).

(suppressed header on new pages)

MISSING_IMAGE:/path/to/gfx/compile-page_settings-no_header.jpg

The page header is suppressed (blue emphasis) on the chapter break page, but otherwise displays the name of that chapter in subsequent pages (tan emphasis).

No header or footer on...

When these checkboxes are enabled, both the header and footer will be removed from the pages that match their respective checkboxes:

* *Single pages*: when the amount of material between two page breaks amounts to a single page; this would most often be seen in cases like book or part level breaks, where a full page is dedicated to some sort of title.

* *Blank pages*: where blank pages are generated in the book, they can also have the header and footer removed from them, as is typical. A com...

Header and footer fonts

At the bottom of the "Headers and Footers" section are two settings for controlling the font and text size of these respective fields. The font family itself can be overridden by the project's compile settings.

The font I've chosen is ignored in my word processor

Make sure the font you select here is used within the document somewhere other than the header or footer as well. Limitations in how this feature work require the font be defined somewhere other than the header or footer fields alone.

Draw dividers for...

A margin-width rule (similar to the appearance of the header in this user manual) will be inserted below the header text, or above the footer text, when these respective checkboxes are enabled.

Use vertical headers and footers

Both the header and footer will be rotated vertical, so that the header is along the left edge of the paper and the footer is along the right. The text itself (and a divider is used) will also be rotated 90°.

Header

Content

This section is similar to [the "layout content columns" in the upper half of the Section Layouts compile format pane][Layout Content Columns]. You can optionally add metadata to the printout for each document that is selected. By default, only Text will be selected, which is the main text body of each document.

Title formatting will be determined by your current Scrivenings title font settings (even if you do not display titles in Scrivenings), in [the Appearance: Scrivenings !preference pane]...

Options

Content

Options

New Project...

Brings up the Project Templates window which will walk you through creating a new project in the location you specify.

Open...

Brings up a file selection dialogue for opening an existing .scriv project on your hard disk. Full read-write permissions must be set for a project to be opened successfully. Older projects may need to be updated; you'll be walked through that process if necessary.

Recent Projects

Here you can review a list of projects that have recently been used recently and select one to open it (you can also specify in the [General Preferences][general - startup] whether Scrivener will reopen all projects that were open in a previous session when it is launched).

The number of items listed in this submenu is governed by your macOS' global preference, which can be set in the "General" system preference pane.

Favorite Projects

Displays a listing of all the projects on this machine that have been flagged as a "favourite". Use this to load or activate the window of the project you select. Read more about it in [Setting Favourite Projects].

Add|Remove Project from Favorites

Adds or removes the currently active project to the aforementioned "Favorite Projects" list.

Show Project in Finder

The active project will be located and presented to you in a new Finder window. This information can also be acquired from the project window title bar, by right-clicking on the name of the project itself.

Find All Projects in Spotlight

<$direct-sale> Runs a Spotlight search, bringing up a Finder window with the search results of all Scrivener projects included within the remit of the Spotlight index. It is important to distinguish the difference between this and searching your entire computer for projects. The Spotlight index may not include drives you have specifically omitted, or external drives you have plugged into the computer. It will also not locate zipped projects (usually a result of automatic backups).

Close Project

Closes the current project and all of its associated windows. The project will be automatically saved upon close, and under default settings will be backed up.

Close Project and Clear Interface Settings

When holding down the Option key and viewing the File menu, you'll see this command for closing a project. This will safely shut down the project and as a final step, trash the project's "UI" preference file. All options such as visible elements (rulers, inspector, etc), splits, label tinting, columns, and other settings will be factory reset. Ordinarily, you'll only ever need to do this as a troubleshooting step, or a way of fixing a layout glitch you've encountered.

Close Window

Closes the currently active window (e.g. Quick Reference, or utility panel). However if the project window has focus or is the only open window for the project, the entire project will be closed instead. Composition mode must be exited explicitly, it does not respond to this command.

Save

Scrivener auto-saves your writings as you work, so that you never have to worry about losing your efforts. Projects are also saved automatically whenever they are closed. However, you can use the save command to force an immediate save whenever you want.

Save and Rebuild Search Indexes

When holding down the Option key you can manually rebuild the search index while saving. This is sometimes useful in cases where you suspect the project has lost synchronisation with the search index. There is typically no need to do this as Scrivener will automatically maintain indexes, and it will rebuild its index if something appears to have gone awry since the last session.

Save As...

Will prompt you for a new project name and/or location. When you submit this dialogue box, Scrivener will immediately start working with the *new* copy, closing the version you had been working on up until that point. If instead you want to generate a backup copy and keep working with the original project, use File//Back Up//Back Up To... instead.

For more information on managing projects, refer to [All About Projects][].

Import//

Commands for importing a variety of existing information, from your drive or even from the Internet, into your active project. For full documentation on importing information into Scrivener, refer to [File Import].

Export//

Provides tools for exporting elements of the binder to the file system. For more information on exporting your work, see [Exporting][].

↳with Mobile Devices

Forces Scrivener to check the current project for mobile changes. In ordinary usage this will not be necessary as these checks are performed automatically when switching to the project from another window and of course when loading the project. If the project window has been open and active while using iOS to edit it remotely, then you will want to use this command to bring the project on your computer back in sync.

↳with External Folder...

Method for creating folders with plain-text, rich text, Fountain or Final Draft files on your system. The export location can be anywhere, including network mounted drives or synchronised folders such as provided by Dropbox, Google Drive, iCloud Drive and SpiderOak. It is thus useful for coordinating with collaborators or even just working on pieces of your project while on the go. See also: [Synchronised Folders][].

↳with External Folder Now

Runs the external folder sync tool immediately without loading the configuration window. If External Folder sync has not been previously set up, it will load the configuration window for you.

↳Back Up To...

Generates a complete backup copy of the project to a specified location. Backup copies, unlike "Save As", will be created and then ignored by Scrivener, you will keep working in the current version of the project. Optionally, you can choose to compress the backup in a zip archive, which takes longer, but is the recommended method for storage of backups, particularly if you intend to copy the backups over the Internet in one form or another.

↳Back Up Now

Triggers the automatic backup system to produce a backup immediately, using the established preferences for backup location and rotation scheme. Customise how this works in the [Backup preferences tab][prefs - backup].

Page Setup...

Accesses the standard page layout setup sheet. Additionally accesses Scrivener specific features from the Settings dropdown menu within this sheet. Most compile formats will use these settings to determine paper size and margins, as well as for current document printing (below). Compile formats can be further configured to use their own settings, including full two-page layouts with offset margins. For full documentation on the standard printing process, read [Printing][].

Print Current Document...

Prints the current editor view. How this will be printed depends on the view mode, with all of settings for this accessed through the File//Page Setup... command, above.

Compile...

Compile is the standard method for producing a manuscript out of all the individual pieces in the Draft. This feature provides an immense degree of flexibility, and is fully documented in [Compiling the Draft][].

Undo & Redo

This and the followings section use As-Is formatting as they are compound entries to multiple standard commands. They cannot be used for shortcut cross-referencing.

Cut, Copy, and Paste

Cut, Copy, and Paste Cmd-X, Cmd-C & Cmd-V

: Cut, copy and paste act exactly as they do in other applications. These commands will not act upon documents that you have selected. They will work primarily with text, but can sometimes also be used to copy and paste metadata like bookmarks or keywords. This manual will make note of where copy and paste can be used for non-textual edits. For editing documents, refer to the [Documents Menu][].

Copy Special//

This menu allows you to copy text or binder items using functions to create specially formatted lists of items, remove markings from the text or convert the text to different formats.

Paste and Match Style

This pastes the contents of the clipboard without any of its existing fonts, styles and other attributes such as links, tables and lists; in essence, treating it like plain-text. Useful for when you have copied a range of formatted text but want to paste it using the style of the text into which you are placing it, such as when gathering material from the Web.

Paste Plain Text as Screenplay

When the active editor is showing a scriptwriting document, this menu command will become available. It can be used to paste plain text formatted screenplays, from the likes of Movie Magic Screenwriter, or even plain text screenplays you compiled from Scrivener in the past. The pasted text will be analysed and converted to the script format. It is only intended to work properly with standard Screenplay based formats.

Delete

In some contexts this command can be used to remove items from lists, such as individual keywords in the inspector pane, and is usually passively bound to the DeleteBackspace key NOTE//WINDOWS// verify the standard shortcut used for removing items from lists on Windows. Is it always Shift-Del? . In similar cases, such as the Bookmarks pane in the inspector, where the removal cannot be undone, it is necessary to use the Cmd-Shift-Delete shortcut instead.

This menu command can also be used to per...

Select All

Edit menu

Select//

Contains several commands to aid in the selection of items and text. In views where things are listed, such as the binder or a list of keywords, and where it is possible to select multiple items, there are a few modifier keys that can be added to mouse clicks to form basic selections:

* Command: toggles whether or not one item beneath the mouse pointer is selected. This can be used to effectively deselect everything, if the one and only selection is Command-clicked. It can also be used to add ...

Deselect All

If possible, removes all active selections from the current view. In some cases there will always be a default selection that cannot be removed. In a text editor, the cursor position takes on that role, and certain commands and tools will use the cursor position as a form of implied selection. In the corkboard and outliner views the underlying container that is being viewed will occupy the default selection, mainly for deciding what the Inspector will examine.

↳Complete

Manually calls up the word-completion service, regardless of word auto-completion settings. Can optionally be invoked with Cmd-. or simply Esc by itself on some keyboard layouts.

↳Complete Document Title

With the first part of a document titled typed in, you can use this command to cause Scrivener to search your project for matching titles and suggest alternatives. This is useful in conjunction with the Corrections preference to automatically detect internal links typed in with `[[Document Title]]` wiki-style bracketing.

↳Add Selection to Auto-Complete List

Adds the currently selected word to the project's auto-complete list. If more than one word is selected, nothing will be added to the auto-complete list. For more information, read [Auto-Completion][].

↳Move Up

With **text** the selected lines will be transposed together with the line directly above them. On the **corkboard**, the card will be moved directly up, advancing all cards between where it was and where it will be moved, one position to make room for it. In both the **binder & outliner** views, the selected items will move up within the current list of "siblings", or within a folder and without changing levels. They cannot be move "up" beyond the top of the group they are within. With **label ...

↳Move Down

As with moving the selected items *up*, only in this case all movement will be done downward.

↳Move Left

NOTE// If the keyboard shortcut changes, this will impact ↳Indents. **Text** will have its block indent level shifted outward by 0.25" increments. Any amount of first-line or hanging indent will be respected by this command. The levels of indent for all forms will be incremented equally, and once the left margin is reached by the leftmost portion of text, the command will be disabled. Items in the **binder & outliner** will be move out of their current container to become a sibling to it, inse...

↳Move Right

NOTE// If the keyboard shortcut changes, this will impact ↳Indents. As with moving the item *left*, only in this case all movement will be done in the opposite direction. In the case of **text**, the indent will be incremented 0.25" per usage and has no effective upper limit. The action of moving an item right in the **binder & outliner** will be to nest the selected items beneath the item directly preceding the topmost selected item.

↳Sort Ascending (A-Z)

This command will sort eligible items in alphanumeric order (0-9a-z) with most punctuation and symbols falling before numbers.

↳Sort Descending (Z-A)

Sorting by descending order follows all of the same rules, only sorts in (z-a9-0) order, with most punctuation and symbols falling at the end of the list.

Add/Edit Link...

Add an external hyperlink of any types to the text. If the cursor is not already placed within a link, you can use this command to insert a new link at the cursor position. When existing text is selected, the hyperlink will be applied to the text rather than inserting the URL directly into the editor. The URL editing sheet will provide you with several common prefix options For the sake of simplicity, both HTTP and secure HTTPS links are considered one and the same. You can also paste a URL with...

Unlink

If the cursor is placed within the text of a link, this command will destroy it. If you select a range of text, all link formatting within that range will be removed. Links only partway selected will remain as trimmed around the bits of the link left unselected.

Link to Document//

Presents a binder item selection submenu for the creation of a hyperlink to a chosen document within the same project at the current cursor position, using the target's binder title, or if you have text already selected, it will be turned into a hyperlink.

Using this menu, you can also create a link to a document that doesn't exist yet, with the New Link... command (<$custom:shortcut>) In the first tab it will ask you for the title of the new document, and where to place it. After providing thi...

↳Quick Search

Provides a shortcut for using the toolbar's quick search field, which [otherwise prints the name of the binder item you are currently viewing](#ui-toolbar-quick_search). If the toolbar has been hidden, a separate window will be opened for your convenience. Read more in [Quick Search Tool][].

(figure)

MISSING_IMAGE:/path/to/gfx/ui-toolbar-quick_search.jpg

[The "Quick Search" tool displays the document title prior to being clicked on.]

↳Search in Project

Provides a shortcut for the project search tool, which will appear as a text pane above the binder sidebar. Type text into this field to search the project for matches, in accordance with the current search settings, set in the magnifying glass icon menu to the left of where you type. There is a lot to this tool! Read more about [Project Search].

↳Project Replace...

Shows the Project Replace panel, for the bulk replacement of text throughout the entire project or selected portions of it, even including the otherwise immutable snapshots. This operation cannot be undone; use with care. Read more about its usage in [Project Replace].

↳Find...

Brings up a standard find and replace panel. This panel works within nearly every context where you can edit text, even within the inspector sidebar. In the main editors this often means only one document at a time, but in the case of Scrivenings session it could mean many documents. Read more about [Document Find and Replace].

↳Filter...

When the active view is a corkboard or outliner, the "Find" command will be replaced with the "Filter" command. This brings up a panel at the top of the view that can be used to filter which index cards or outliner rows you see, based on various criteria. Read more in [Filter Outliner & Corkboard Views].

↳Find Next / Previous

Find Next/Previous Cmd-G & Shift-Cmd-G

: Jumps to the next or last matching text based on the criteria supplied in the Find panel. Note these can be used even if the find panel is closed.

↳Use Selection for Find

Sets the selected text as the current find term, copying it into the "Find" text field even if the find panel is closed. It can thus be combined with the previous commands to search for text without using any interface.

↳Jump to Selection

Scrolls the editor view so that your cursor position is centred on the page. Useful if you have used the scrollbar, or PageUp/PageDown to briefly check other areas of the text.

When [typewriter scrolling] is enabled this command will use the selected Typewriter scroll line, from the Editing !preference pane, rather than the centre of the view.

↳Find by Formatting...

Opens the Find by Formatting panel. This tool is quite powerful and has a wide range of options documented in [Find by Formatting Tool].

↳Find Next / Previous Formatting

Find Next / Previous Formatting Shift-Opt-Cmd-G & Ctrl-Opt-Cmd-G

: As with Find Next and Find Previous, this command will jump from match to match, even without the "Find by Formatting" panel open. Unlike document find however, this command will seek matches from adjacent documents once the end of the current document is reached. In this way, you could step through the entire project looking for matching formatting.

↳Show Spelling and Grammar

Opens the standard Spelling and Grammar panel. If you wish to change the base language the spelling and grammar checker uses, you can set that here.

↳Check Document Now

Start checking for misspellings from the current cursor position on downward. Once the bottom of the document is reached, it will wrap around to the top.

↳Check Spelling While Typing

Toggles the automatic spell\\ checker that underlines in red unrecognised and misspelled words as you type, unless Correct spelling errors as you type has been enabled in the [Corrections preference pane][prefs-corrections], under "Auto-correction".

↳Check Grammar With Spelling

Toggles the grammar checking feature that looks for poor style or grammatical errors as you type and underlines them in green.

↳Smart Quotes

If necessary, typographic punctuation will be substituted for basic speech mark punctuation as you type. In English for example, the \" character would be substituted with a matching pair of “ and ” characters. The quotation style used are typically set by your macOS localisation settings, or quote settings established in the "Text" tab of the Keyboard System Preferences pane.

For those cases where the text editor produces the wrong type of quote, such as after em-dashes, press the Option key i...

↳Smart Dashes and Ellipses

With this option enabled a sequence of two or three hyphens in a row will be substituted with an em-dash (---) character, and three full stops will be converted to an ellipses (...) character.

↳Make Uppercase

Converts the selected text to all uppercase characters.

↳Make Lowercase

Converts the selected text to all lowercase characters.

↳Make Title Case

Converts the selected text to title case, capitalising each word in the selected range.

↳Make Small Caps

Creates fake small caps by capitalising all of the letters in the selection and then using font sizes to produce the effect. If your workflow requires true small caps you should use the typography features of your font to display this format, instead.

↳Remove Small Caps

In opposition to the previous command, removes the faux caps effect, restoring the original letter case and normalising the font size based on the larger letter found within the selection (ignoring letters using a smaller font to the left). Given how this command requires precise expected measurements between large and small letters, it will only work on text that has not had its overall font size modified after applying faux small caps.

↳Quotes to Smart/Straight Quotes

Converts between typographic\\ "curly" quotes and straight speech marks.

↳Inline to Inspector and Inspector to Inline Conversions

These four\\ commands allow you to convert inline annotations to linked Inspector comments, vice versa, and footnotes. These commands work on the current editing session as a whole or the current selection if applicable.

↳Delete Struck-Through Text

Within a range of selected text, any that has been marked for removal with the Format//Font//Strikethrough command will be deleted. Struck-through text can also be filtered out of compiled text as an option, without removing the original text in the editor. This command is only necessary if you wish to clean up the source.

↳Update Document Links to Use Target Titles

Any internal links found wi-thin the selected text will have visible text of the hyperlink changed to match the names of the documents that they are pointing to. Thus, a line of text reading "Update this" which has been selected and linked to a document named "To this", will have the visible text changed "To this". If you are using links to display cross-references in the compiled output, this command will be useful when the names of sections have been revised. Read more about compiling cross-re...

↳Replace Multiple Spaces with Single Spaces

Useful for cleaning up a document that has been typed up with multiple spaces in between sentences and so forth.

↳Remove Empty Lines Between Paragraphs

Strips out empty lines between paragraphs, as will often be found in emails and plain-text documents.

↳Strip Leading Tabs

If the original document was typed in the fashion one might do when using a typewriter, with tabs in front of every paragraph, this command can be used to strip them all out.

↳Zap Gremlins

Strips Unicode and ASCII control characters from the selection. If you are having difficulties compiling, or have found areas in your text where the cursor seems to get "stuck" when moving through ranges of text, your document may have acquired these invisible control characters from somewhere. This command will strip out all of the Unicode characters falling within the range of `#x00` to `#x1F`, save for the necessary `#x09`, `#x0A`, `#x0C` and `#X0D` characters, which are used to print spaces,...

↳Look Up in Dictionary and Thesaurus

Sends the currently selected word, or the word that the cursor is currently located within, to Apple's Dictionary application. You can also use Ctrl-Cmd-D to do quick spot-checks, or use a "force click" action on compatible hardware.

↳Search in...

Uses the currently selected text or active word to search the selected resource for results. Your preferred Web search tool (as set in Safari) will be used and, along with Wikipedia searching, will require an active Internet connection to make use of.

↳Linguistic Focus...

Brings up a floating panel that provides access to macOS [linguistic word highlighting features][Linguistic Focus].

↳Name Generator...

A tool which will generate names based on a wide variety of criteria. Read more in [The Name Generator][].

↳Line Break

Inserts a soft-break instead of a full paragraph break. Use this when you need to create a list within a single paragraph.

↳Page Break

Inserts a page break within the current text. Page breaks can be previewed with the View//Text Editing//Show Page View mode. In most cases, Scrivener's compile system will insert page breaks for you, relegating use of inserting them manually to niche cases.

↳Non-Breaking Space

Inserts a special space character which will prohibit word-wrap from dividing the words joining that space. I.e. for the purposes of word-wrap, it will consider a sequence of words separated with non-breaking spaces as a single word.

↳Word Joiner

Inserts an invisible Unicode character which has zero-width, but otherwise acts just as a non-breaking space, ensuring the two characters to the left and right of it are never broken between lines by word wrap.

↳Centered Line

Inserts a sequence of 100 underscored non-breaking spaces with centre-alignment formatting applied to the line. You can increase or decrease the size of the line by adding or deleting non-breaking spaces.

↳Page-Spanning Line

Uses an underlined tab stop, set to the width of the page as it will be compiled, to draw a line across the page. Given how Scrivener's text editor may not depict the width of the page in terms with how it will compile, the tab stop may in some cases fall before or after the editor width or simulated text block in Page View, causing the rendering of the line to collapse and become invisible.

It is also important to note that since this uses a tab stop with a fixed measurement, if the paper size...

↳Signature Line

Inserts a sequence of 40 underscored non-breaking spaces with left-alignment formatting applied to the line. As with centred lines, you can adjust the width by adding or removing non-breaking spaces to the line.

↳Show|Hide Header & Footer View

Toggles the visibility of the header and footer bar in the active editor.

↳No Split

Removes the inactive split from the editor, returning it to one. For more information on using splits, see [Splitting the Editor][]. This command does not remove copyholders directly.

↳Split Horizontally

Initiates a new horizontal split, or converts the split orientation to horizontal. When creating a new split, the current content will be loaded into that split.

↳Split Vertically

As with splitting horizontally, only vertically instead.

↳Swap Editors

Only available when Split Horizontally or Split Vertically is enabled. This command swaps the editors from one side to the other, so that the view on the top/left will become the view on the bottom/right and vice versa. This swaps the entire editor session, its history, settings and so forth. What was the left editor will now be functioning on the right side instead.

If you would instead prefer to merely mirror the content into the other editor without swapping settings, use the "Match Split Do...

↳Copyholder Position//

Also accessible by right-clicking on the copyholder's header bar directly, you can set which side of the editor it favours using the options in this submenu. A copyholder cannot be positioned parallel with a split, so some options may not always be available, or be swapped for you when the spit configuration changes.

↳Show|Hide Format Bar

Toggles the visibility of the character and paragraph formatting bar, which provides quick access to many of the most common types of formatting tools. Refer to [The Format Bar][] for more information on this tool.

↳Show|Hide Ruler

Toggles the visibility of the [tab-stop and indent ruler][The Ruler] for the active editor.

↳Show Titles in Scrivenings

When enabled, editable titles of documents will be placed between documents in a scrivenings session above their associated texts. Titles can be formatted, and the divider style changed, in the [Appearance: Scrivenings pane][appearance - scrivenings].

↳Only Show Scrivenings Titles for Folders

The editable titles added by the former menu toggle will only appear on folders, with all other items will use a regular divider.[^ <$include>]

↳Show|Hide Invisibles

Toggles visibility of hidden control characters, such as paragraph breaks, table cells (when otherwise set to have no borders) tabs, spaces and [page breaks][Supported Invisible Characters with Symbolic Depictions]. You can modify the colour used to depict these symbols in the [Appearance: Textual Marks][appearance - textual marks] pane.

↳Show|Hide Markup

Toggles the display of textual markings, to produce a cleaner copy suitable for proofreading. The markings that will be hidden by default are comment highlights, links, highlight boxes around styled text and preserve formatting boxes. You can adjust which markings are hidden in the [Appearance: Textual Marks !preference pane][appearance - textual marks].

↳Show|Hide Page View

Toggles displaying the text editor as a virtual page on and off, rather than text in a long column. It is not intended to be used as a layout mechanism, though it can provide a reasonable estimate of how your pages will look under certain conditions, once printed. This setting is specific to each split editor, as well as composition mode. Read more in [Page View][].

↳Two Pages Across

When enabled, displays two pages side by side in a familiar book-style arrangement.

↳Use Vertical Layout

This is a global setting that toggles the rotation of the main editors (including composition mode) to vertical alignment, as is sometimes used in Eastern scripts like Japanese.

↳Show Line Numbers

Adds a paragraph (line feeds within a paragraph will not be counted) numbering feature to the standard editor. This feature is unavailable to Page View mode.

↳Only Count Every Fifth Line

As an option to showing line numbers above, you can elect to have Scrivener only count every fifth paragraph.

↳Show|Hide Compiled Footnote Numbers in Inspector

When enabled, after you compile and all footnotes have been counted, their [numbering will be printed in the Inspector alongside the footnote itself][Compiled Footnote Numbering]. This option can slow down compile times, and is thus off by default.

↳Prompt Before Updating Footnote Numbers

In conjunction with footnote numbering, optionally instruct the compiler to ask you if these numbers should be updated, every time you compile. This can be of use if the project is very large, as adding numbers takes time and may not always be necessary.

↳Typewriter Scrolling

Toggles a feature that keeps the currently edited line of text at a set position on the screen, much like typing on a physical typewriter. This setting is specific to each split editor, as well as to composition mode (the latter has the feature enabled by default).

↳Automatically Resize

Keeps the PDF sized to the width of the editor window even when changed.

↳Actual Size

Zooms the PDF to its native scale.

↳Size to Fit

Like "Automatically Resize", but only resizes the document once. If you change the size of the editor view later, it will stay at the same zoom level.

↳Single|Facing Pages

In Single Page mode, will show one page per row like an ordinary digital file. In facing mode, two pages will be placed side-by-side in a column, more like reading a book.

↳Continuous / Page Breaks

These two scrolling modes affect how the document is handled when using the scroll wheel, arrow keys, or page up and down keys. In Continuous mode, the pages flow by seamlessly; in page break mode, only one (or two, if facing pages is enabled) pages will be showed at a time, and scrolling actions flip between pages.

↳Cards Across//

The Cards Across submenu allows you to define how many index cards you would like to appear in each row on the corkboard. The default is three. Auto-fit will calculate how many cards to show, based on the size of the editor and the size of the cards; kind of like word wrap, for index cards.

↳Arrange by Label

Toggles a mode whereby index cards are [arranged by label on the corkboard][Arrange by Label]. Each label forms a "rail" that matching cards are placed upon in the order they appear within the corkboard naturally. Whether these rails form rows or columns can be adjusted with the following menu options.

↳Arrange by Label Layout//

These choices select between the rotation of the corkboard layout or whether it wraps cards to the view, as described in [Stacked Corkboards][]. Grid orientation (or how the corkboard behaves by default) is only available when stacking, never when Arrange by Label is enabled, even if stacking a label-arranged view. These options are also available as buttons along the bottom right in the corkboard footer bar, and on the Touch Bar with appropriate hardware.

The name of this menu will change depe...

↳Show Label Colors Along Edges

Toggles whether a coloured strip is drawn along the edge of index cards. These strips are associated with the label colour assigned to the item the card represents. When no label has been assigned to a card no strip will be drawn on it.

↳Show Status Stamps

Toggles whether stamps are displayed on index cards. Stamps show the current status associated with the document represented by the index card as though it has been stamped on the index card. The appearance of stamps can be adjusted in the "Fonts" and "Colors" tabs of the [Appearance: Corkboard !preference pane][Appearance - Corkboard].

↳Show Keyword Colors

Keywords assigned to a document can be visually indicated along the right-hand side of the index card as colour chips. The number of keywords that can be shown at once can be changed using the corkboard display options button.

↳Show Card Numbers

Cards will be numbered according to their sequence in the selection or container they are within. In Freeform mode the numbers will not change according to where the card is positioned in the view. This can be a valuable reference as the order of cards are likely to become shuffled up. This option impacts both splits.

↳Number Per Section

When this option is enabled, if the corkboard is displaying multiple containers in a "stack", card numbering will be restarted for each new section. When disabled card numbering will be linear across sections.

↳Freeform

Activates the [Freeform Corkboard][] mode, allowing unrestricted movement of cards around on the corkboard without any immediate impact on their underlying order in the binder. This can also be toggled in the footer bar, and on the Touch Bar with appropriate hardware.

↳Snap to Grid

Toggles whether or not cards in freeform mode will snap to a background grid, rather than allowing for pure freeform placement.

↳Commit Freeform Order

Uses the current freeform layout to reorder the actual manuscript outline structure. Scrivener will provide [several options for how this can be done in a dialogue box][Commit Order]. If card numbers are enabled, they will be renumbered at this time to reflect the new underlying order. This command can also be invoked via the Commit button in the corkboard footer bar.

Center Content

Toggles whether the current outliner view will have its content horizontally centred (much like the text editor centres the text column by default). This will be more useful with a limited number of columns, and will have no visible effect if there is more outliner width than the current view affords. This behaviour can also be toggled via a [button in the outliner footer bar][Centring Outliner Content].

Use Fixed Row Height

Toggles whether or not the current outliner view will used a fixed height cell for each row, rather than an adaptive height that conforms to the amount of content in various columns. For more information, refer to [Using a Fixed Row Height].

↳Show as Background Color in Binder

When ticked, this option causes the binder title to be coloured with the label background, rather than using a dot to the right of the name. This option has no impact on the other sidebar views. The intensity of this background can be modified by the opacity slider (which impacts the label tint used in other background areas) in [the Appearance: General Interface !preference pane][Appearance - General Interface].

Zoom In

Increases the magnification of the current view by a set amount. In text views this amount correlates with the provided values in the "Text Zoom" section of the menu, or what can be seen in the zoom tool in the text editor footer bar.

Zoom Out

Decreases the magnification of the current view in an inverse pattern to zooming in.

Text Zoom

The "Text Zoom" section of the menu lists a number of convenient and popular zoom settings for text.

Fit Width

Adjusts the magnification so that the page width (including margins) fits the current editor width. This and the following option are only available when using [Page View mode in the text editor][Page View].

Fit Page

Sets the magnification so that both the short and long edge of the page can be seen within the editor.

Other...

Provides a field where you can type in a precise magnification amount yourself. If you'd prefer a number between 200% and 300% say, this would give you the option for doing so.

↳Expand All

Expands all collapsed items recursively within the current view. When this command is used in the binder, it will expand the entire binder. If you instead wish to only expand or collapse one single section of the outline, you can use the OptionAlt key in conjunction with a mouse click or the LeftArrow (to collapse) or RightArrow (to expand).

This command can also be used in the Footnotes & Comments inspector pane to expand all collapsed notes to full height.

↳Collapse All

As with Expand All, this works the other way, closing all visible open items recursively.

This command can also be used in the Footnotes & Comments inspector pane to collapse all notes to single lines.

Collapse All to Current Level

Working in a similar fashion to Collapse All, this command will collapse the entire outline below the currently selected item's level. Thus if you if have an outline that has six levels of depth, and select a folder on level 3, running this command will completely collapse all items except those at levels one, two and three, which will be ignored.

When multiple items are selected, the first item in the selection will be used to determine the level by which the tree will be collapsed.

Show Subdocument Counts in Binder

When enabled, each container in the binder will display a number to the right of it showing how many subdocuments it contains. This number is recursive, meaning that it will not only count the container's immediate children but any descendants beneath those children as well.

Hoist Binder

With this command, temporarily obscure the full binder and focus on only one portion of it. In other words, hoisting will display the selected container all by itself in the binder sidebar. Changes made to ordering and structure while hoisting will be made to the book outline itself. Read more about it in [Hoisting the Binder].

Unhoist Binder

Returns the binder to full display. You can also click the CloseButton button in the binder sidebar header to return to the full binder.

Customize Toolbar...

Opens the configuration panel for the main application toolbar. This can also be done by right clicking on the toolbar itself.

↳Previous Document

Jumps to the previous item in the binder sidebar list. When used with the main binder view visible, this command ignores hierarchy.

↳Next Document

As with Previous Document, but selects the next document in the binder sidebar list.

↳Enclosing Group

Will display the currently edited item in context with its siblings using the current view mode, and can be thought of as a way of moving your editor "up" in the hierarchy one step at a time. In most cases, this will select the immediate parent of the document, selecting the document's index card or outliner row that you came from, or expand your current Scrivenings session to include the siblings and parent of the current text item.

↳Selection

Jumps directly to the text component of any selected item. This works as an isolation feature in Scrivenings, or can also be used to quickly open selected items from the corkboard or outliner as text (even if they are containers). When more than one item is selected, they will be loaded using Scrivenings mode as a multiple selection.

The difference between this and the Navigate//Open// commands (<$custom:shortcut> or <$custom:shortcut>) is that they will respect the current view mode preference...

↳Collection//

This submenu contains a list of all available collections in the project. Rather than loading the collection in the sidebar, as would ordinarily be done, this command loads the contents of the collection into the editor, where it can be worked with using any of the group view modes.

If the collection is already being displayed in the sidebar, you can also load it into the editor by clicking on the HookArrow button in the sidebar header (beside the CloseButton button) . Read more about this capa...

↳Convert to Standard Collection

When a Search Result Collection is the active tab, this command will "freeze" the results and turn it into a regular collection that is no longer dynamically updated. This is a one-way process that cannot be undone, and the original stored search settings will be discarded. Refer to [Converting a Saved Search to a Standard Collection] for more.

↳Next Collection

Select the next collection tab in the stack, as shown in the tab list.

↳Previous Collection

Select the previous collection tab in the stack, as shown in the tab list.

↳In Current Editor

The actual labels of this and the next menu command will change depending upon the current editor that is active, and whether or not split orientation is horizontal or vertical, to make it more clear which editor the item will be loaded in.

Use this command to open the selected items in the current split, replacing what you are currently working with.

↳in Other Editor

Open the selected items in the inactive split, opening a new split if necessary to do so. For example you can select a card in a corkboard and use this keyboard shortcut to open a split and load the contents of that card into the split.

↳as Quick Reference

Opens the selected document in a [Quick Reference panel][Quick Reference]. When in a Scrivenings session, the current segment of the overall session that is currently active will be opened as a Quick Reference panel.

↳in Copyholder

Opens the selected document in the [copyholder for the current split][Using Copyholders], opening a new one if necessary. When used in a Scrivenings session, the currently active segment of text will be loaded alone.

↳in Quick Look

This menu command is only available for types of files that Scrivener does not support with its built-in viewer. It will make use of your Mac's native Quick Look viewer, similar to having selected a file of that type in Finder and opening Quick Look from there.

↳(with) Compilable Subdocuments

Working in a manner similar to "With All Subdocuments as Flat List" (below), this loads into the view only those items that are set to [include in compile][General Metadata]. Read more about [filtering items in group view][Filter Outliner & Corkboard Views].

↳With All Subdocuments as Flat List//

Useful for cases where you'd like to see all of the cards in a particular section of your outline, even if they are nested several layers deep. The result of this command is a multiple selection, which means the items cannot be reordered as all depth information is lost by viewing cards this way.

* *On Editor Corkboard*: replaces the current editor view with the selected item's contents. This is similar to pressing <$custom:shortcut> to open selected cards on the corkboard, only it also will a...

↳in External Editor

This command will open a file using the default editor for that type of file (for example, loading a PDF in Preview). This command is available on any type of item that is not a text or folder document. Opening items this way allows them to be viewed and edited in their native applications. Any edits made externally will be saved back into the project seamlessly. If Scrivener can display the type of file you edited, you might need to [refresh the viewer to see your changes][Reloading Edited Rese...

↳Lock in Place

Locks the editor (or split) so that no external navigation commands (such as clicking in the binder) will affect it, causing the other editor split, if available, to load the request instead (this behaviour can be adjusted in the Behaviors: Navigation !preference pane, by setting When focused editor is locked in place to "Binder selection does nothing"). When an editor is locked, its header bar will turn a shade of red. Read more in [Locking the Editor].

↳Lock Inspector to Editor

Available when the editor is split, this command locks the inspector sidebar to the currently active split. Ordinarily the inspector tracks the selection within whichever split you are currently working in. When this is engaged, the inspector header bar will turn red and the split it is locked to will be indicated by a red "inspector" dot in the header bar. You can now use the other split while leaving inspector material alone and available for reference. Read more about [Locking the Inspector].

↳Lock Group View Mode

Available only when the active editor is displaying a group view, or if the selected item is a container (folder, or file group acting as a folder). Any view mode can be locked, including single text document mode. Locking is a per-item setting, and is saved into the folder or container itself. The view mode will stick to what was in use at the time it was locked. You can change its saved view mode by simply switching the view mode while viewing the item. Read more about [Locking the Group View ...

↳Scroll to Previous Page

These menu commands will only activate when Page View is enabled on the active editor, or when viewing a PDF. This command will scroll the view so that the top of the previous page is flush with the top of the viewer, keeping the reading area stable as you browse.

↳Scroll to Next Page

This command scrolls the view so that the top of the next page is flush with the top of the viewer, keeping the reading area stable as you browse.

↳Forward in Document History

Much like a Web browser, the editor keeps track of everything you've visited within the project. Using these commands you can navigate back and forth in the history. You can also use the Forward and Backward buttons in the header bar (right-click on them to access the full history as a list). Each split keeps its own history.

This command visits the document you were looking at prior to having gone back in history to the current document.

↳Backward in Document History

This command visits the document you were looking at before you navigated to the current one, and if you use it again, to the one you were visiting before *that*, and so on.

↳Other Editor//

There are a few commands accessible as keyboard shortcuts while typing in one editor that have an impact on the *other* editor without removing your typing focus from the current editor. I.e. You can scroll the other split and operate its history even while writing in another document.

↳Clear Document History

Use this command to wipe out the document history for the active editor.

↳Play Media File

Functionally, this acts like clicking the Play or Pause button in the media viewer, for either audio or video files.

↳Fast Forward

Jump playback forward by two seconds. This shortcut works while playback is running or paused. In the latter case, it will stay paused at the new position.

↳Rewind

Jump playback backward by two seconds, and otherwise follows all of the rules outlined above.

↳Rewind on Pause

This project setting toggles the behaviour whereby whenever media playback is paused, upon resumption it will be rewound by a determined number of seconds in the [Behaviors: Playback !preference pane][behaviours - playback].

↳Rotate through main views

This menu item follows a chain of the three most common areas of desired focus: the two editor splits and the binder. It will cycle between these three going left to right, and the label of this menu item will be changed to indicate where the next target will be.

↳Binder

Moves focus to the binder sidebar from anywhere in the interface, if visible.

↳Left|Bottom Editor

Moves focus to the Left or Bottom editor, if the editor has been split. When the view is not split, this command will be named "Editor" and will select the main editor.

↳Right|Top Editor

Moves focus to the Right or Top editor, if the editor has been split. When the view is not split, this command will be named "Other Editor", and will naturally be disabled.

↳Header Bar Title

Moves focus to the editor header bar title area where you can edit the name of the item you are currently viewing in the editor. If you are viewing something that cannot be renamed (such as a multiple selection) then the command will be disabled. Use !Return to confirm your changes and bring the typing focus back into the main viewing area of the editor.

↳Copyholder

If only one copyholder is visible on the screen (or none), then this command will be named "Copyholder", and target it no matter which split the focus is current in. Otherwise it will target the copyholder that is attached to the editor that is currently active, and the menu name will be altered accordingly.

↳Notes

Reveals or switches focus to the notes tab. Use the Synopsis command below to focus the upper portion of this tab.

↳Bookmarks

NOTE//WINDOWS// Look up shortcut used for switching scope.

↳Metadata

Reveals the metadata tab, and switches focus to the Custom Metadata pane within it. Use Tab and Shift-Tab to navigate between text and date fields. Use the Keywords command below to switch focus to the lower third of this tab.

↳Snapshots

Reveals or switches focus to the snapshot list. Use arrow keys to flip between available snapshots and view their contents in the preview area below.

↳Comments and Footnotes

Reveals or switches focus to the comments & footnotes tab. The UpArrow and DownArrow keys can be used to navigate through the list, and RightArrow and LeftArrow to expand and collapse selected notes.

↳Synopsis

Reveals the notes tab and switches focus to the synopsis text area. Use the Notes command above to focus on the lower portion of this tab. Use the Cmd-7Ctrl-7 keyboard shortcut to switch between viewing the synopsis as an image or text.

↳Keywords

Reveals the metadata tab, and switches focus to the Keywords pane within it. Arrow keys can be used to navigate amongst keywords; !Return can be used to add new keywords; and !Delete to remove keywords.

↳Previous Group

Jumps the selection to the previous visible container in the active outliner or binder, no matter what the depth. If a container is currently hidden, it will be skipped. If you only wish to select the parent container of a the current item, you can use the LeftArrow key.

↳Next Group

Working in the same fashion as Previous Group, only selecting the *next* visible container downward from the current position.

↳Current Editor

This is the default behaviour out of the box. Whichever split you worked in last will be targeted.

↳Other Editor

Whichever split is *not* currently active will be targeted. This way your current work space is never disturbed by usage of the binder.

↳Top|Left Editor Only

The top or left split (depending upon orientation) will always take binder clicks no matter which split is active.

↳Bottom|Right Editor Only

The bottom or right split (depending upon orientation) will always take binder clicks no matter which split is active.

↳Both Editors

In this special case, *both* editors will update whenever you click on something in the binder. This will most often be useful when using two different group view modes. You could have an outliner in the left view and a Scrivenings session in the right, both showing the same area of the binder in their own unique ways.

↳None

Neither editor will update when using the binder. In this mode of usage, you will always need to manually open items into an editor. This can be done by using the Open commands in the right-click menu or Navigate menu, or by drag and drop into the header bar.

↳None

This is the default behaviour. Clicking on rows in the outliner or cards in the corkboard will never automatically open those items in other views.

↳Other Editor

When selecting items in the corkboard or outliner view, they will be automatically loaded into the other split view using its preferred view settings.

↳Copyholder

If a copyholder has been attached to the current editor, you can elect to have any individually selected items loaded within it automatically, turning it into a viewer for the split.

↳Take Snapshots (of Selected Documents)

When viewing any text or folder document, this command will take a snapshot of the current text and store it for later use. When selecting items from a list of any sort, the title of this item will change to "Take Snapshots of Selected Documents", and all selected documents will have a snapshot taken of them.

How to snapshot an entire folder

Selections must be precise, but you can easily select a folder and all of its subdocuments with a single command, Edit//Select//Select with Subdocuments (<$custom:shortcut>), from an outliner or binder view, and then take the snapshots.

↳Take Titled Snapshots (of Selected Documents)

You will be asked to provide a name for the snapshot before it is taken. This name will be displayed in the snapshot list. It is always possible to adjust the names of snapshots after they have been taken.

↳Show Snapshots

Switches to the snapshots tab in the inspector, revealing the inspector if necessary. This command is functionally identical to Navigate//Inspect//Snapshots.

↳Show Changes//

When a snapshot is selected from the snapshot list, it is possible to view the changes between that snapshot and the current document. If two snapshots are selected, these two snapshots will be compared between each other, using the oldest snapshot as the original.

Comparisons can also be performed in the main editor or copyholders. Refer to [Comparing Changes in the Editors] for more information.

↳Roll Back

Rolls back to the selected snapshot, replacing the text in the main editor. The option to snapshot the *current* editor text, before reverting the text, will be given in a dialogue box.

↳Delete

Permanently removes the selected snapshot from the disk. You will be asked to confirm this action as it cannot be undone. You may also delete snapshots with the backspace key, or by clicking the DelButton button in the Snapshots Inspector.

↳Show Snapshots Manager

Opens [the Snapshots Manager] window, where all snapshots in the project can be browsed and managed from a convenient central location.

↳with Subdocuments and Unique Title

The entire item (including all of its children if it has any) will be duplicated, and it will be provided with a unique name automatically. If the current title ends in a hyphen + numeral, Scrivener will use an incremented number in the copy. For example is the document you are duplicating is called "scene-5", duplicating it would result in a file called "scene-6". It will otherwise add "-1" to the end of the duplicated item, starting a new sequence if further duplications are made. %BinderConte...

↳without Subdocuments

This is most useful when you only want to duplicate the container of an item by itself, such as a chapter folder, but not all of the scenes within it. In this case, a unique name will *not* be provided.

↳at Selection

Split the new document off from the current one, using all text after the current caret position (this can even split a paragraph in two). In cases where text has been selected, the caret position will be considered as the start of the selection range.

↳with Selection as Title

In all details this command works identically as the above, but in this case the currently selected text will be used to title the new document that is created, rather than leaving the title empty.

↳Text to Default Formatting...

Resets the text of the selected files and folders (or the text in the active editor session, including multiple documents in Scrivenings) to the default formatting used for new files, as established either globally in the [Editing: Formatting !preference pane][editor - formatting], or on a per-project basis in [project settings][project settings - formatting]. You may also wish to read more about [Resetting Formatting] in general.

↳Script Format...

Useful when you need to switch from one scripting standard to another. Note that if all you wish to do is change the current document writing mode, you should use Format//Scriptwriting//Script Mode (<$custom:shortcut>) to do so. This function is strictly for converting between pre-existing scripts to bring them up to spec. For more information on scriptwriting, see [Scriptwriting].

↳to File|Folder

Converts the selected items to folders or files respectively. Note that these two document types are very similar in Scrivener, so this tool makes it easy to change your mind later about whether or not something should be a folder or a file. If the selection contains a mix of types, or items that are neither files nor folders, then the command will be disabled. %BinderContext

↳Web and PDF files to Text

Activates when viewing an MHT format WebArchive or PDF item. Will scour the file for its text content and create a rich text file from it that is editable and considered a text document from that point onward. Note this cannot be undone. Create a duplicate of the original beforehand if you wish to retain a copy with its full layout.

↳Set Selected Text as Title

When text has been selected in the main editor the title for the current document will be set to that selection. If you are splitting up a longer document into a format more useful within Scrivener, consider using the Documents//Split//with Selection as Title (<$custom:shortcut>) menu command instead.