OmniGraffle 3 Reference Manual for iOS

Document Toolbar

The Document Toolbar is located above the canvas whenever you are working in an OmniGraffle document (diagram, stencil, or template). The Document Toolbar is unique, in the sense that it provides you with document-specific things that you can do; from opening and closing the Navigation Sidebar or Inspectors, exporting the current canvas, or adding a stencil—a pre-drawn object—to the canvas.

An image of the document toolbar isolated in OmniGraffle for iPad.

Document Toolbar

The Document Toolbar features the filename for the document that you are working on, along with a series of buttons to the left and right for working with the current document.

Hide/Show Sidebar a rectangle with two intersecting lines

Tap to hide or show the sidebar along the left side of the screen.

Documents Documents icon

Tap to close the current document and return to its folder in the Document Browser.

Document Title

The toolbar displays the name of the current document here. Tap to edit and change the file name.

On narrow devices the document title is hidden to leave room for more functional button controls. You can always change the title of your document by tapping its preview icon text in the document browser.

Only files stored in your On My [device] folder or a connected OmniPresence folder can be renamed within OmniGraffle. To rename other files (such as those stored in iCloud Drive), tap the filename in the document browser instead.

Starting with OmniGraffle 3.19 and iPadOS 16, the document title adds a menu that includes controls for sharing the document in various ways (in addition to renaming it), as described in Sharing and Exporting.

A screenshot of the document title menu in OmniGraffle 3.19: a dropdown menu from the document title text in the toolbar with controls for sharing the document.

Sync with OmniPresence OmniPresence icon

This icon appears to the left of the document filename if the file is synced via OmniPresence. The icon indicates whether a sync is in-progress; tapping the OmniPresence icon initiates a sync.

This icon doesn't appear in the toolbar in OmniGraffle 3.19 on iPadOS 16.

  • Sync Ready The Sync Ready icon

    In its most basic state, OmniPresence is online and ready to sync files.

  • Sync In-Progress The Sync In-Progress icon

    Whenever OmniPresence notices a change to the files in the sync folder, the icon appears to be lifting a barbell.

  • Sync Offline The Sync Offline icon

    If you lose your Internet connection (which is required for syncing), the icon turns light green to denote that you are offline.

  • Sync Error The Sync Error icon

    If you see a light green sync icon with an exclamation mark, it means that OmniPresence failed to connect to the sync server. This could be the result of an invalid Account Name or Password, or something as simple as an intermittent Internet connection that drops while OmniPresence is trying to connect to the sync server.

    If the icon remains in this state, here are some things you could try:

    • Double-check your Account Name and Password.
    • Check your network connection in Settings.app.

    If that doesn’t help, contact our Support Humans for assistance.

Undo/Redo a hooked line with an arrow that points to the left

Tap to undo the previous change to your document. Touch and hold to reveal a pop-up menu with the option to Redo.

Sharing and Actions a square with an arrow inside that points upward

Tap to open a menu containing options for exporting or sharing the document you are working on. See Sharing and Exporting in the Document Browser chapter for details on the menu options.

Starting with OmniGraffle 3.19 and iPadOS 16, the Share button no longer appears in the toolbar and can instead be found in the Document Title menu.

Add Stencils and Images a plus sign

Tap to open a menu for adding a stencil or an image from your Photos library to the canvas. See Using the Stencils and Images Menu for additional details.

Automation This is an OmniGraffle Pro feature a greater-than symbol followed by an underscore

Tap to open a menu with options to open the Automation Console or to view the Automation API Reference. This is an OmniGraffle Pro-only feature, used for scripting OmniGraffle with Omni Automation.

Inspectors a circle with a lowercase i inside

Tap to open or close the inspector bar along the right side of the screen.

More an ellipsis

If you see three dots in the toolbar, this implies there are more options/buttons available than there is space for in the toolbar. Tap to open the More menu, which presents the other available options.

Starting with OmniGraffle 3.19 and iPadOS 16, the toolbar adds a More menu with a new icon The new More icon, a circle with three dots in a horizontal line and controls for customizing the document toolbar and accessing the OmniGraffle app menu.

Customizing the Toolbar

On an iPad with iPadOS 16 or later and OmniGraffle 3.19 or later, you can customize the document toolbar to include a variety of additional controls not present in the default toolbar arrangement.

To customize the contents of the document toolbar, open the More menu The new More icon, a circle with three dots in a horizontal line and choose Customize Toolbar.

The custom toolbar editor appears, where you can drag controls up to where you'd like them in the toolbar; you can also remove or rearrange existing controls by dragging them to different spots in the toolbar.

Tap Reset in the editor header to restore the toolbar to its default set of controls.

Customizing the toolbar in OmniGraffle 3 Pro.

If there isn't enough room in the toolbar for all of the controls you add, any that don't fit are added as menu items in the More menu instead.

Note that changes you make to the document toolbar apply across all documents.

Using the Stencils and Images Menu

Tap the plus sign button in a document’s toolbar to open the Stencils and Images menu.

Photo Library a camera

Tapping the camera icon in the menu provides you with the following options:

  • Take Photo: Choose this option to use the camera on your device to take and place on the canvas a picture.
  • Choose Existing: Choose this option to select and add to the canvas a photo in your photo library.
  • Use Latest: Choose this option to place on the canvas the last picture you have taken using the camera on your device.

The first time you tap the plus sign button, you need to authorize OmniGraffle to access your photo library.

Installed a windowpane shape with rounded corners

A list of stencils installed on your iOS device which are available to add to the canvas. See Adding Stencils to the Canvas to see how it’s done.

  • To install stencils in the default OmniGraffle location, use the Files app to copy the .gstencil files into the OmniGraffle folder on your device (On My Device > OmniGraffle) or the OmniGraffle folder in iCloud Drive (iCloud Drive > OmniGraffle).

  • To add stencils from other locations on your device, use Configure Resource Locations in OmniGraffle Settings to connect the folders that contain them.

Stenciltown

View available stencils on Stenciltown, Omni’s free online stencil-sharing service. See Downloading and Using Stencils from Stenciltown to see how it’s done.

Use the Search field to quickly find stencils Installed on your device, or available for download from Stenciltown.

Adding Stencils to the Canvas

To add a Stencil that’s installed on your device, tap the Add Stencil button in the toolbar, choose a stencil set, and then tap or drag a stencil to the canvas.

Adding a stencil to the canvas

Downloading and Using Stencils from Stenciltown

To download stencils from Stenciltown, tap the Add Stencil button in the toolbar, choose Stenciltown in the menu, and then search for the stencil you are looking for and tap Download to add the stencil set to your device.

Downloading stencils from Stenciltown

Searching on—and downloading from—Stenciltown requires an Internet connection.