examples

An Introduction to Shortcuts for Mac

In this year’s macOS release, Apple finally brought the Shortcuts app from iPhone and iPad to the Mac. We immediately knew what a game changer this would be for Mac users looking to automate their workflows. That’s because Shortcuts is accessible by design, yet powerful with the right setup. So naturally, we jumped on board and added initial support for Shortcuts in Diagrams 2.2 in the form of three shortcut actions.

If you’ve never heard about Apple’s Shortcuts app, let us introduce you to the new world of automation on Mac.

What Is Shortcuts?

Shortcuts is a preinstalled app that allows you to create so-called shortcuts, which are configurable sequences of actions that perform a certain task. Setting up shortcuts is almost like programming, but it’s way more approachable because it’s all visual and you don’t have to write any code — though you can, if you wish. How complex or straightforward the operation sequences you create are is really up to you. And the best thing is that Apple deeply integrated Shortcuts into the system, which brings your automation actions to the next level.

You can create shortcuts from scratch, import examples from Apple’s gallery, or download them from the internet. In fact, we prepared a bunch of sample shortcuts we think you might like. You’ll find them at the end of this post.

All the shortcuts in your library are synced across all your macOS, iPadOS, and iOS devices via iCloud. And, of course, after importing a shortcut into your library, you can further tweak and remix it according to your needs. Read on to learn how this works.

How to Create Useful Shortcuts

The system offers a wide range of building blocks in the form of actions such as choosing an option from a menu, counting things, changing settings, opening files, and so much more. These actions can be found in the sidebar of the editor and arranged into a sequence via drag and drop. Every installed app — be it Apple’s or a third-party one — can offer more actions as well. You can see the actions of all your apps in the sidebar when switching to the Apps tab.

That’s where Diagrams comes into play. Starting with version 2.2, we offer three actions you can use in your workflows. These actions allow you to work with Diagrams’ documents — for example, to export files without opening the app. The export step can be chained with additional actions to process the outputs — e.g. to save, further manipulate, or upload them, to name a few options.

But how do you trigger your created shortcuts? The simplest way is to activate them inside the Shortcuts app. Performing a workflow with multiple steps using one simple click is already pretty powerful. Though, like mentioned before, the true power of Shortcuts comes with the deep system integration!

Integrate Shortcuts into macOS

Depending on your goal, it’s possible to choose from different combinations of triggers for each shortcut. This allows you to work with your shortcuts in various places.

For example, why don’t you trigger a shortcut that creates a new Diagrams document with your favorite palette preset via a systemwide keyboard shortcut? This way, regardless of what you’re doing right now, you can simply press that keyboard shortcut, and the system will perform your actions. In a similar fashion, you can also opt to display your shortcuts in a dedicated menu bar item, like you can see above, and run them via a mouse click.

And then there are Quick Actions, which are a powerful way to integrate your shortcuts into Finder or other applications on your Mac. Let’s look at those next.

Getting Inputs

By configuring your shortcuts with Quick Actions, you can make them receive inputs from different sources throughout the system, like selected text or documents on your disk. There are three options: Finder integration, listing in the service menu, and buttons in the Touch Bar. The rest of this section will cover the first two.

The Finder Quick Action adds a shortcut to both the information panel and the context menu and passes the selected files to it when triggered. It allows you to design workflows such as creating a new document with the palette of a selected file. Simply select a file, run the shortcut, and save a lot of time!

The service menu is a feature that dates back to the first version of macOS. It’s accessible via either the app menu (to the right of the  button) or by right-clicking text or files. Previously, the system and third-party apps could offer custom actions here. Starting with macOS Monterey, you can list your shortcuts by enabling the appropriate option in the sidebar of the editor. You can change the actions that appear in the service menu via System Preferences > Keyboard > Shortcuts > Services.

Based on the configured input type (text, documents, folders, URLs, etc.), macOS shows only the shortcuts relevant for the current context, ensuring a smooth workflow.

That’s enough theory, don’t you think? Let’s get a bit more practical.

Shortcut Examples for Diagrams

Diagrams 2.2 ships with three actions you can use in your workflows: 

  • Create Document with Palette Preset 

  • Create Document with Palette from Existing Diagram 

  • Export Document

While it’s only the beginning of automation support, these actions already allow you to build powerful timesavers. To give you an idea of what’s possible, we’ve compiled a handful of samples you can play around with. Click the cards below to download them to your Mac.

Please note that you might run into an issue when importing shortcuts, causing the Finder Quick Actions setting to be reset. You might want to reenable this option in the sidebar for some shortcuts to get the most out of them.

This shortcut is made for those of you who like to have their own palette template library. A Diagrams template file is simply a document with a custom palette, and it doesn’t have to contain an actual diagram, but it can. Check out our sample diagrams if you’re looking for inspiration. Now, place your template files in a folder, select this very folder in the shortcut, and you’re all set.

Each time you start the shortcut, you can choose from those templates to create a fresh new document with your palette ready to go.


Previously, adding footnotes required postprocessing in a separate program. With this shortcut, you can skip this step and create footnotes automatically. For example, maybe you want to go for a copyright note that always stays the same. However, if you prefer to choose a text each time, select Ask Each Time for the text value in the overlay action (via right-click). Or how about adding the current date via a magic variable? Get as wild as you want!


Do you want to highlight certain things in a diagram or enrich it with notes? This shortcut will quickly export a Diagrams document and open the system dialog for making annotations. After you’re done, the result will be saved on your desktop — or in any other location you like.


Do you often share diagrams with others? Then this one is for you. All you have to do is select the Diagrams document and let the shortcut do the work. It’ll automatically export your diagram and upload it to Imgur, a free image hosting service. The URL of the uploaded image will then automatically be copied to your clipboard, ready to be pasted in your conversations.


With everyone working from home, video calls with friends or colleagues are part of our daily lives. Why don’t you use a shortcut that sets up your machine and apps to see and hear everyone well? To kick off your meeting, you might want to take notes in a new Diagrams file. 😉


Since introducing the Examples Library on our website, we’ve had to manually export each sample diagram to both the PDF and PNG formats from within the app, for every update. This process was tedious — but not anymore! With this shortcut for batch exporting a set of Diagrams documents, we’ve been able to simplify it. If you happen to export multiple diagrams at once, you should check this one out.

Final Words

We hope we managed to give you a general introduction and overview, along with some inspiration for building your own shortcuts. However, there are still plenty of details to learn about. We suggest starting with Apple’s official guide for Shortcuts on Mac.

If you want to dive deeper and become a true automation master, you might want to check out the What’s New in Shortcuts newsletter published by Matthew Cassinelli, a former developer of the Shortcuts app. Another great learning resource with tips and tricks is David Sparks’ Shortcuts for Mac Field Guide.

And last but not least, if you’re looking for more third-party apps that support Shortcuts, you should check out this editorial story on the Mac App Store. In addition to Diagrams, it lists more than 50 apps across all categories. You can get these apps directly from the page, and then it’s only a matter of enabling their shortcut actions and integrating them into your workflows to make them more powerful.

We’re eager to hear about your Shortcuts creations! Feel free to tweet them to us. And as always, we’re happy to hear any feedback and ideas from you.

Happy automating!

Automation and More Flexibility with Diagrams 2.2

We’ve just released Diagrams 2.2, which adds new options for configuring element and relationship types in the palette. It’s ready for macOS Monterey, and it includes initial support for automation with Shortcuts.

New Shapes and Arrows

Since it was first released, Diagrams has only supported basic shapes and arrow heads. When we made the palette customizable earlier this year, all attributes became configurable, but we only added new element colors and text formatting options. To continue our efforts in extending the flexibility of diagram creation, we’re introducing eight new element shapes and eleven relationship heads. You’ll find them in the respective pop-up menus in the palette.

New Shapes and Heads in Diagrams 2.2

By taking advantage of these additions, you now gain the ability to create even richer diagrams. When designing your palette, choose your desired shape for element types, and adorn relationship types with fitting heads at both ends for the perfect arrow.

In addition to specific palettes, there are also generically applicable use cases for these new options. For example, it’s now possible to make a Note appear like a sticky note and a Document appear like a sheet of paper. Diagrams can also get closer to the standards of certain visual languages like flowcharts or UML, as certain object types are now representable. The following overview shows a few examples. To get even more inspiration, you can browse through our updated Examples Library.

Palette Examples

Flowcharts

We refreshed the built-in presets and focused on flowcharts, a very popular diagram type among Diagrams’ userbase. As illustrated above, we made some adjustments to the existing element types and introduced two new ones:

  • Subprocess — Represents a larger, multistep process that is defined elsewhere, e.g. in a separate flowchart.

  • Input/Output (sometimes called Data) — Indicates information entering and leaving the process. This might include user input and UI output in the software domain; or controls, sensors, and displays in the hardware domain.

While these two types aren’t fundamental to most flowcharts, having them at hand allows you to be more expressive, should you have advanced needs. To give you an idea of how they might be used, we prepared a sample diagram:

Flowchart Sample Diagram

Automation with Shortcuts

This year, Apple brought its visual automation system, Shortcuts, from iOS to the Mac. Diagrams 2.2 adds support for Shortcuts by providing three actions for creating and exporting Diagrams documents. Beginning with macOS Monterey, you can integrate these actions into your custom workflows to automate recurring tasks. If you’d like to learn more about Shortcuts, we have an in-depth blog post for you.

Diagrams 2.2 is a free update, and it’s available on the Mac App Store and Setapp. For the full list of changes, you can refer to the release notes. We hope you like these new features!

A Guide to Palettes

Diagrams 2.0 Macaw, the biggest update to our app, has just been released. In addition to optimizations for macOS Big Sur and Apple Silicon Macs, it introduces a lot of new functionality. In this post, we’ll explore the most significant addition: palettes. For a detailed overview of all features and improvements, please head over to the release notes.

Getting Started

Up until now, Diagrams let you pick from a fixed set of shapes and colors for elements and arrow types for relationships. Over the past few months, we’ve received plenty of requests from you, our users. The message was clear: You want more flexibility. And we heard your feedback and agreed that the single static palette was simply too restrictive. That’s why we removed this limitation with Diagrams 2.0, and for the first time, enabled each of your documents to have its own different palette.

We’ve mentioned the term “palette” a few times already, but what do we mean exactly? Let’s take a closer look. A palette is a collection of element and relationship types. Every document contains exactly one palette, which is specified upon document creation and can be further adjusted. Each type within the palette encodes a meaning and visual appearance for diagram objects it’s applied to. The association between an element or relationship and its type is permanent, meaning that changing the attributes of a type affects all objects associated with that type. Pfff, do these definitions sound overwhelming? Then let’s get more practical.

Getting-Started.png

When you create a new document, you’re asked to select a palette. There are multiple options, and you can choose the one that best fits your use case. The most straightforward way is to start with one of the three built-in palette presets (A): Universal, Grayscale, or Flowchart. Another option is to start with an empty palette and build your types later (B).

Once you’ve created a few documents with custom palettes, you can leverage a third option and load a palette from an existing document to reuse it in a new document (C).

Palette Customization

After a document is created, you can start constructing a diagram using types from the palette you selected, but you can also customize the palette to fit your needs. You can add new types, remove unnecessary types, or change the appearance of existing types. There’s a new palette customization interface for this purpose, which is accessible from the toolbar (Palette), from the main menu (Palette > Customize Palette…), or via Cmd+1.

Palette-Customization.png
  1. List of all element or relationship types

  2. Create and remove types

  3. Indicator of change

  4. Preview of selected type

  5. Optional title of selected type

  6. Visual attributes of selected type

  7. Indicator and details view listing all changes from the session

The left pane lists all available element or relationship types, depending on the tab selected in the top bar. The selected type is reflected in the right pane; it shows a preview and allows you to name it and configure its visual attributes.

While many of the preexisting visual attributes were brought over from Diagrams 1.0, with Diagrams 2.0, we’ve introduced a bunch of new ones as well. When it comes to elements, you can set the shape, color, and text in the caption. And in the case of relationships, you can set the line style, configure arrow heads separately at each of the ends, and format the label.

Once you’re done editing the palette, you can apply changes and save them in your document. This workflow is efficient when performing a multistep customization of the palette, as it allows you to make all changes at once. However, you can also access type editing directly from the canvas.

For example, when adding a new element via a double-click on the canvas, you can click the “+ New” button and create a new type using a familiar interface. The ability to create or edit types on the fly while working on your diagram keeps you from interrupting your flow.

Palette-Customization-2.png

Creating Custom Palettes

With all these preset options, you might be wondering why you’d ever want to start with an empty palette. What’s the point of creating a diagram with no types at hand? Well, starting with a clean slate gives you the freedom to build your palette as you go while working on a diagram at the same time. Moreover, this approach makes it possible to craft a personalized palette that isn’t cluttered with types you don’t need.

Creating a palette from scratch might be the right approach when you have a specific idea in mind or you want to build a diagram one step at a time. Depending on your use case, you might be better off starting with a preset, quickly outlining the diagram, and converting the types from the preset to an organized palette. If you’d like to work in a more freeform manner, you can simply use one of the generic presets and disregard the palette logic.

Embracing the palette, organizing your types, and giving them meaning by naming them comes with many benefits. Not only do your diagrams become better structured and more consistent, but the ability to reuse your types makes you faster and more efficient. This is even applicable across multiple documents, since you can reuse your personalized palettes in new documents.

Now that we’ve covered the theory, let’s talk examples for a moment. The image below shows a variety of palettes. Along with the Flowchart palette that’s available as a built-in preset, you can find palettes extracted from diagrams in our examples library. If you’re looking for a source of inspiration, go check them out.

Create-Custom-Palettes.png

It’s completely up to you if and how you configure your palettes. Diagrams doesn’t dictate which palettes to use or how exactly to organize your types. It does give you tools and just enough freedom to get creative. We believe this unique approach is ideal because our users come from different domains and have different use cases, and our app caters to all those possibilities. The “one-size-fits-all” rule doesn’t always apply.

Where Does This Lead?

If you’re coming from Diagrams 1.0 and you were a true fan of its simple nature, don’t worry. While we made the app more powerful, we tried to keep the palette functionality as unobstructive as possible. Enriching the app’s capabilities without compromising on simplicity is a general principle we strive for, and we think we delivered on it this time.

You might be surprised to discover we didn’t introduce an inspector sidebar that would enable changing attributes directly on the canvas selection. This pattern, which is common in apps that are seemingly similar to Diagrams, doesn’t fit with our semantic approach or our overall vision for the app. We see Diagrams as a diagramming app that supports you primarily when working in a structured manner.

That being said, we see a lot of possibilities of how to expand on the new palette functionality. While you can already import palettes from existing documents, it’s certainly possible to build a general import/export for palettes or even add support for storing your palettes as presets. Now that the visual attributes of element and relationship types can be set individually, there are so many directions we could take this, and boy, do we have a lot of ideas!

With version 2.0, the app has made a major step toward its maturity, but there are still many fundamental features we’d like to add, especially related to the canvas and system integration. The work on the palette kept us busy over the past couple of months, and we’re now ready to continue focusing on our roadmap. But we can assure you that Diagrams has a brighter future than ever. To follow along on our journey, you can find us on Twitter or subscribe to our newsletter. Until next time!