Take actions from your doc with the click of a button. Learn how to create buttons, customize them, and use them to automate tasks.
With buttons, you can add even more interaction to your Superhuman Docs - allowing you to turn your doc into a customized app for your team. Buttons have countless applications and can work in tandem with other building blocks. They’re a great way to save time and elevate your doc.
Add buttons to your page
Buttons can be added to both the canvas of your doc and to tables. To add a button to your doc canvas:
Type /button anywhere on the canvas to surface a list of button options.
Choose from any of our pre-built buttons (like Open hyperlink or Copy doc), or choose New button to start from scratch.
Once your button is added, jump down to Configure your button for next steps
💡 Tip: you can copy and paste buttons and we'll retain them in their entirety so you can move them around as need be!
Add buttons to your table
In addition to creating buttons on your page, you can add button column types to your tables. You would want to use buttons in a table over buttons in a canvas if you want to incorporate content from the row in some form in the button. For example, if you want a button to email a project owner in a table of projects, you would set up a button column and configure it to only email the person in the same row.
To add a button column to your table:
Click on the plus icon (+) in the upper right corner of your table to add a new column
For column type, select Button.
Once your button column is added, jump down to Configure your button for next steps
Configure your button
Once you’ve added a button to your canvas or a button column to your table, it’s time to configure your button. This is where you can specify what you want your button to do, when it should be disabled, and how it should appear.
-
In the button configuration panel, you’ll first see the On click field. This is where you specify what you want your button to do when clicked. Choose from any of the options in the dropdown, or click the f symbol in the upper right to open the formula builder.
💡Tip: In addition to Superhuman Docs’ native button actions, there’s also a whole suite of Pack button actions - including Send Email (via the Gmail Pack), Post Message (via the Slack Pack), and more. Check out this article to learn more about Pack buttons.
-
Depending on which option you choose from the dropdown, you’ll then see different fields. Complete the fields accordingly.
Jump to the section below to see some common button setups.
-
Under the Visual section of the button settings, set a label (the text that will be displayed on your button).
💡Tip: Check out this video to learn how to use an image instead of text for your button’s label.
Then choose the size (for canvas buttons only), the color, and the icon.
If needed, you can also customize the Alerts and Advanced sections of the button. Check out the following sections to learn more.
Alerts
In the Alerts section of the button settings, you can determine the alert behavior that users will experience when clicking the button, including...
Ask for confirmation: Toggle this on if you want the user to see a confirmation pop-up whenever they click a button. This is especially useful for buttons that are erasing data, sending notifications, or taking some other hard-to-undo action.
Confirmation message (only visible if Ask for confirmation is toggled on): While the button alert will default to "Are you sure?", you can customize the language of this pop-up as needed. Add a static label, such as "Are you sure you want to delete this row?" - or use a formula to create a dynamic message, such as "Are you sure you want to delete [insert task name]?"
Cancel button and Continue button (only visible if Ask for confirmation is toggled on): Choose the verbiage for the cancel and continue buttons. You can even enter a formula to create dynamic labels that change based on the row values.
Show alert after running: By default, you’ll see a small pop-up at the bottom of your doc whenever you click a button. You can use the Show alert field to change this behavior to Every time, Never, or Only for errors.
Advanced settings
Under the Advanced section of the button settings, you can really fine-tune your button.
-
Disable if: If you want your button to be disabled under certain circumstances, add a formula to the Disable if field.
For instance, maybe you want your button to be disabled after a certain date. You can enter the formula: today()<=ToDate("03-30-2023") . Then the button will be disabled starting on March 30th, 2023.
Badge: Use the optional Badge field if you want a number to be displayed in the corner of your button.
Name (canvas buttons only): Optionally, you can also give your button a Name. This lets you easily refer to the button in future formulas.
Voilà! You've got a beautiful button!
Some button examples
Buttons have limitless potential. But if you’re new to buttons and need some inspiration, check out these examples:
FAQs
Can I see all the buttons in my doc?
You can see all the canvas buttons in your doc by clicking on the gear icon in the upper right of your doc, and selecting Doc map. Here you’ll see a section titled Other Objects, which includes all canvas buttons. Note that buttons columns are not included in this.
Can I use a button to send someone a notification?
Yes! You can create a button that sends custom notifications to a person (or people). To do so, choose the Send message or notify user action from the On Click dropdown menu. If you want to send a notification in Superhuman Docs, choose Notification from the Send as options.
Alternatively, in that Send as field, you can choose to send a Slack message or an email via Gmail. If you haven't yet, you'll need to go through the process of connecting those Packs to your doc.
How can I deactivate buttons?
Buttons can be deactivated using the Disable if field, under the Advanced section of the button settings. This field requires a formula input, so head on over to this article if you need a formula refresher.
Is there a way to prevent certain people from pushing buttons?
By default, anyone with edit access can push buttons in your doc. But you can change this in a few days.
You can use the Disable if field (see above) to specify when your button can be clicked - and by whom.
If you’re on a Team or Enterprise plan, you can also use locking to limit the use of buttons on specific pages.
Is there a way to display a confirmation screen when someone clicks a button?
Yes! Within the button settings, open the Alerts section. Here you will see an option to Ask for confirmation. When this is toggled on, users who click the button will see a pop-up asking for confirmation. They will need to either click again to continue or click to cancel. Learn more in the Alerts section above.