Configuring Buttons on Templates
The Button Content element creates a prominent, clickable call to action within your template. Buttons can direct recipients to a webpage, open a new email message, initiate a phone call, or move the recipient to another section within the same email. You can customize their wording, action, appearance, spacing, and responsive behavior to fit the purpose and design of your communication.
Adding a Button to a Template
To add a Button, open the Content tab and click and drag the Button element onto the desired location on your template. Once added, select the Button on the template canvas to open its available settings on the right. From there, you can update the Button wording, configure what happens when it is selected, and adjust its visual design and placement.

Button Text and Formatting
When a Button is first added to the template, the default label will display as Button Text.
To change the wording, double-click the Button directly on the template canvas. Your cursor will appear inside the Button so you can replace the default text with your preferred call to action, such as Donate Now, Register Today, Learn More, or another message appropriate for the communication.
While your cursor is active inside the Button, a text formatting toolbar will appear above it. These options allow you to format the Button text independently from the Button's overall design settings.
Font | Selects the font used for the Button text. |
Font Size | Adjusts the size of the Button text. |
Bold | Applies bold formatting to the selected text. |
Italic | Applies italic formatting to the selected text. |
Underline | Adds an underline to the selected text. |
Strikethrough | Adds a line through the selected text. |
Merge Tags | Inserts available DonorDock merge tags into the Button text. |
💡 Keep Button text short and action-oriented whenever possible. Longer wording may cause the Button to become wider or wrap onto multiple lines, especially on mobile devices.
Action Settings
The Action Type dropdown determines what happens when the recipient clicks on the Button in the received email.
Open Website
Open Website is the default Action Type and is the most common option for Buttons. When selected, two additional settings are available:
URL | Sets the webpage or online resource that opens when the recipient selects the Button. This could be your organization's website, a DonorDock Giving Page, an event registration page, a volunteer form, or another online destination. |
Target | Determines whether the destination opens in the same tab or a new tab. New Tab is selected by default. |
For example, a Donate Now Button could use the Open Website action to direct recipients to your organization's Giving Page in a new browser tab.
Send Email
The Send Email Action Type allows a Button to open a new message in the recipient's default email application.
Three fields are available:
Mail To | Sets the email address that will automatically populate as the recipient of the new message. |
Subject | Sets the subject line that will automatically populate in the new email. |
Body | Adds predefined text to the body of the new email message. |
When the Button is selected, the recipient's supported email application opens a new compose window with the configured information already populated. The recipient can then edit the message if needed before sending it.
For example, an event email could include a Contact Our Events Team Button with your organization's event email address already entered, a subject of Question About the Annual Gala, and a short introductory message in the body.
This reduces the information the recipient must enter manually and provides additional context when the message reaches your organization.
Call Phone Number
The Call Phone Number Action Type allows you to enter a telephone number that should be used when the recipient selects the Button.
On a compatible device, selecting the Button prompts the recipient to start a phone call using the provided phone number. This action is particularly useful for communications expected to be viewed on mobile devices.
For example, a Call Our Office Button could let someone reading the email on their phone start the call without manually copying or entering your organization's phone number.
Keep in mind that the recipient's device and email application determine how telephone links are handled.
Go to Page Section
The Go to Page Section Action Type creates an internal link to another section within the same email.
When selected, a Page Section dropdown allows you to choose from sections that have already been named within the template. When the recipient selects the Button, the email moves to the selected section rather than opening an external destination.
This can be useful for longer communications, particularly newsletters. For example, a Button near the top of the email labeled View Upcoming Events could take the recipient directly to an Upcoming Events section farther down in the same message.
Page Sections can also be used with Menu and Text links to create internal navigation throughout a longer email.
Button Appearance Settings
Button Options control the visual appearance of the Button itself. These settings remain available regardless of which Action Type is selected.
Background Color
Background Color controls the button color.
Select the color field to open the available color controls. You can choose a color visually from the gradient grid, enter a specific HEX or RGB value, select from standard colors, or choose from available Template Colors.
Template Colors are suggested based on colors already being used within your template, making it easier to maintain a consistent color palette across different Content elements.
Text Color
Text Color controls the color of the wording displayed on the Button.
The same color selection tools are available, including visual color selection, HEX and RGB values, standard colors, and Template Colors.
Choose a Button background and text color with enough contrast that the wording remains easy to read. For example, a dark Button background paired with light text generally provides better readability than two similar shades.
Width
The Width setting controls the Button's overall horizontal size.
By default, Auto Width is enabled. When Auto Width is turned on, the editor automatically sizes the Button based on the amount of text it contains.
For example, a short Button labeled Give will generally be narrower than one labeled Register for the Annual Gala.
To control the Button width manually, turn Auto Width off. A slider will then let you increase or decrease the Button width.
Manual width can be useful when you want multiple Buttons within a template to have a consistent size or when the Button should occupy more of the available Content area.
Line Height
Line Height controls the amount of vertical space used between lines of Button text.
The default Line Height is 120%. This value can be increased to create additional space between lines or decreased to make multi-line Button text more compact.
For most Buttons, particularly those containing only one line of text, the default setting generally provides appropriate spacing.
Letter Spacing
Letter Spacing controls the amount of horizontal space between individual characters in the Button text.
The default setting is 0 px. Increasing the value spreads the letters farther apart.
Small adjustments can be a design choice, especially for short Button labels, but excessive letter spacing can make longer Button text harder to read.
Button Alignment
Alignment controls where the Button is positioned within the available Content area. Depending on the available layout options, the Button can be aligned left, center, right, or justified.
Alignment applies to the Button as a whole rather than to the text within the Button.
Button Padding
Padding controls the space between the Button text and the outer edges of the Button.
By default, Button padding is set to 10 px and applied equally to all sides. Increasing the padding creates more space around the Button text and generally makes the Button appear larger.
To control each side individually, enable the More Options toggle. Separate values can then be entered for:
Top
Right
Bottom
Left
For example, you may choose to use greater left and right padding to create a wider Button while keeping the vertical height more compact.
Button Padding is inside the Button. The separate Container Padding setting controls the space outside the Button element.
Border Outline
Border settings let you add or customize an outline around the Button.
Border Color | Sets the color of the Button outline using the available color picker, HEX value, RGB value, or other available color options. |
Border Width | Sets the thickness of the Button outline in pixels. |
Border Style | Determines the outline appearance, such as Solid, Dotted, or Dashed. |
By default, the same border settings are applied to all four sides of the Button. Enable More Options if you want to configure the Top, Right, Bottom, and Left borders separately. This can be useful for more customized designs where individual sides need different widths or border treatments.
Rounded Border Corners
The Rounded Border setting controls how much rounding is applied to the Button's corners. The value is set using pixels. A lower value produces corners closer to square, while a higher value creates progressively more rounded corners.
By default, the same radius applies to all four corners, but you can enable More Options to set each corner individually: Top Left, Top Right, Bottom Left, Bottom Right.
Using the same radius on all corners generally provides the most consistent Button design, while individual controls are available when you need a more customized appearance.
General Content Settings
Additional settings are available for the Button Content element itself. These settings control the area surrounding the Button or how the element behaves within the overall template rather than changing the Button's internal design.
Container Padding
Container Padding controls the amount of space surrounding the Button element within its Content area.
The default Container Padding is 10 px on all sides.
Increasing this value creates more separation between the Button and nearby Content elements. This can be useful when a Button feels too close to the Paragraph, Image, Divider, or other Content around it.
Enable More Options to control each side separately using Top, Right, Bottom, and Left values.
It can be helpful to distinguish the two padding settings this way:
Button Padding | The space between the Button text and the edges of the Button itself. |
Container Padding | The space between the Button and the surrounding Content within the template. |
Section Name
The Section Name field allows the Button Content element itself to be identified as a Page Section within the email.
Enter a short, recognizable Section Name if you want another Menu item, Button, or supported link elsewhere in the email to direct recipients to this location.
For example, if a Button appears at the beginning of your donation section, you could give the element a Section Name such as donate. Another Button or Menu link near the top of the email could then use Go to Page Section to direct the recipient there.
Section Names are most useful when building internal navigation for longer Email templates.
Responsive Design Settings
Responsive Design settings allow you to control whether the Button should appear based on how the recipient is viewing the communication.
In Desktop view, the Responsive Design setting includes a Hide on Desktop toggle. When enabled, the Button will not appear when the email is displayed using the desktop layout.
In Mobile view, the setting changes to Hide on Mobile. When enabled, the Button will not appear in the mobile version of the email.
Hiding an element in one view does not delete it from the template. It allows you to create different experiences for desktop and mobile recipients.
For example, you might create a larger call-to-action Button intended specifically for mobile users and hide it on Desktop, while using a different layout for recipients opening the email on a larger screen.
Button Tips
Before using the template, review each Button to make sure the wording is clear, the selected Action Type is correct, and the destination or other configured action works as expected. It is also a good idea to review the Button in both Desktop and Mobile views so its size, spacing, and placement remain easy to use across screen sizes.
Once you configure your Button, save the template and send a test communication to confirm the Button displays correctly and performs the intended action for the recipient.
