Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Add a Button with the Rich Content Editor

Add a Button to trigger actions or redirect users to different content.

Before you begin

Role required: sn_cd.content_manager

Fill in the New content form fields. See Create rich content

Create the page layout using modules or columns.

Procedure

  1. Navigate to the canvas by selecting the Open editor button from the Design tab of the New content form.
Image omitted: ecpro-open-editor.jpg
Open the Rich Content Editor from the Design tab
  1. From the Rich Content Editor canvas, you can use a drag-and-drop method to add a button.

  2. Navigate to Settings tab.

Image omitted: ecpro-settings-tab.jpg
Settings tab on the side of the canvas has styling configurations
  1. See full configration settings options.
Image omitted: ecpro-settings-tab-details.png
Configuration options under the settings tab
  1. Use any of the following styling settings:

    Note: Changing the button type or size will clear all other setting properties and values. The background-color layer will be removed when changing the button type, and some values might be affected by button size selections, such as font size, line height, padding and border radius.

Settings fieldDescription
Styling
Button type

Defines what kind of button you are adding. Your choices are:- Primary (default) - Secondary - Link only

Note: All properties and background color layers will be cleared when changing the button type.

Button size

Defines the size of your button. Your choices are:- X-Small - Small - Medium (default) - Large

Note: All button size properties will be cleared when changing the button sizes.

DisplayConfigure the appearance of multiple components within the same column, such as an image and a text component. Select from the following options:- Top and bottom (default): Image appears above the other component. - Side by side: Image appears with the other component next to it. Note: For best results, set the same display for the components. For example, if you have an image and text components in a column and want the image to appear on the left and the text to appear at the right, change the Display settings for both components to Side by side.
Horizontal alignSets the button alignment. Choose from left, center, or right.
Advanced styling
Button color

Change the color of your button. 1. Enter the color code that represents the background color you want to appear.

Note: All HTML colors are supported. For more information, see HTML color names.

  1. Or, you can select the color picker (grey square) to the right of the Background Color field.
  2. Click into the color palette that appears.
  3. After selecting a color from the color palette, use the slide bar on the right side to fine tune your color.
  4. Slide the bar up and down.
  5. Use the bottom slide bar to lighten or darken your color.
WidthHeight

Adjust the width and height of a button by selecting it and using the Width and Height drop-downs to enter number or use the up and down arrows.You can also choose the unit of measure you prefer by selecting the single down arrow key to the left of the up and down arrows. The choices are:

  • auto: Size is based on the content within the tab. If you enter additional text in the tab, the width automatically increases.
  • px: Use pixels as your measurement.
  • %: Use a percentage as your measurement.
MarginAdjust the margins or the space outside and around the button.Use the drop-downs under the Margin section to adjust the margins on the top, bottom, right, and left sides. Just like the width and height, you can choose the unit of measure you prefer by selecting the single down arrow key to the left of the up and down arrows.
Border

Edit the border around the outside of the button.Note: The border is the outline around the button.

Width: Use the up and down arrows to adjust the width of the border. Just like the width and height, you can choose the unit of measure you prefer by selecting the single down arrow key to the left of the up and down arrows.

Style: The format of the border around the button. Select the drop-down to select the type of border you want around the button.

Color: The color of the border around your button. Select the color of your button using the color palette and slide bars similar to how you select your background color.

Border radiusUse the up and down arrows to adjust the radius of the border. Just like the width and height, you can choose the unit of measure you prefer by selecting the single down arrow key to the left of the up and down arrows.
Font nameDefines the font face used to render characters.Click the drop-down arrow to select a different font.
Font sizeSets the size of the font.
Font weightDetermines how bold or light your text appears.Click the drop-down arrow to select a different weight.
Line heightSets the vertical distance between two lines of text.
Font colorOverrides the font color from your portal theme.To select a color, enter the hex code or click the color picker \(grey square to the right of the font color\) and select a color from the color palette.
Properties
Button labelText that appears on the button.
TitleText that appears when a user hovers over the button.
URLLocation of a web page or content. Enter the complete URL address you are targeting when a user selects the button.
TargetIndicates where the button directs the user. Your choices are:- This window: Selecting the button opens the content in the same window you have displayed. - New window: Selecting the button opens the content in a new window.
  1. Select Save or Save and Finish.

    Selecting Save saves your content and you remain on the Rich Content Editor canvas. Selecting Save and Finish saves your record and returns you to the New content form.

What to do next

  • (Optional) Translate your content.

    Request language translation for your content. For more information, see Multilingual support in the Content Library.

    Note: Only translate content after you are done modifying the content. For best results, we do not recommend that you add or remove components or change the formatting after translation.

    To create rich content that is formatted differently in different languages, duplicate the content and modify the formatting as needed. Then, use Audiences to target the content to users by language. See Audiences

  • Preview your content from the Publish tab.

    Note: Content Preview is designed to provide a general idea of how your content looks. Content may look different once published due to variations in device resolution, theme difference, or mobile app style configuration.

  • Configure a publish plan to control where the content is delivered, the audience, and the period of time it is available: Create a publish plan for your content.