Simple Testimonials
On this page:
Introduction
Testimonials are a great way to showcase a message from a third party. Usually a positive review, or other words of endorsement.
The Simple Testimonial macro allows you to insert a testimonial message into your Confluence pages. Each testimonial macro can be configured with the testimonial message, as well as the name of the person that provided the testimonial, their company/position, and an avatar/image for the person.
Example Testimonials
Here you can see just a few examples of the different ways you can configure a testimonial.
How to Insert the Testimonial Macro
To add the Simple Testimonial macro to a Confluence page:
Use the macro insert menu "+" from editor toolbar, and select the Simple Testimonial.
Alternatively, type '/' in the editor to trigger the macro insert suggestions and type 'scm testimonial'.
Configuring the Simple Testimonial Macro
Once the macro is inserted, it will automatically trigger the configuration dialog, allowing you to customize the testimonial.
Template Tab
The first screen you'll see in the Configuring dialog is the Template screen, where you'll find a collection of pre-made templates. These should give you a quick starting point for various different visuals. Selecting one of the templates will apply the settings for that template, with the results visible in the preview area in the middle.
Content Tab
To customize the content of the Testimonial, like customer name, and testimonial message, navigate to the Content tab.
The content tab gives you easy access to the things you want to edit the most: the testimonial message, the name of the person that left the testimonial, their position, and an image for that person.
Advanced Config Tab
If you want to further customize your Testimonial, navigate to the Advanced Config tab, where you can change virtually everything.
The advanced config dialog is split into multiple groups, each of which has its own settings drawer. Click one of the fields to open a drawer and change the relevant settings.
Testimonial Visuals Settings
The testimonial Visuals drawer allows you to change the visual settings of the button.
Setting | Description |
|---|---|
Background Image | Add a background image to the testimonial using our image picker. If no image is selected, the Testimonial will show a solid color background. |
Background Color | Give the testimonial a solid color background. Note that the color will only show if there is no background image selected. Change the background color using the color swatch. |
Container Width | Set whether the container around the testimonial will be narrow or wide. |
Container Paddiing | Control how much spacing the testimonial has on the left/right and top/bottom. |
Container Border | Enable/disable an optional border for the testimonial via a toggle button. |
Border Color | Pick the color for the testimonial border from the color swatch. |
Border Color Hover | This will be the color of the border when a user hovers over the testimonial with a mouse pointer. |
Border Width | Change the width of the border using the size controls. If the border width is zero (0), the border color and the active borders on the testimonial are not displayed. |
Border Radius | Change whether the border should be squared or rounded using the size controls. Increasing the border radius gives the testimonial rounded corners. |
Active Borders | Set which side of testimonial the border(s) is/are shown. You can have full control over the border visuals for your testimonial by selecting which side to display individually. |
Image Picker
The Image picker drawer allows you to select a background image to be used.
The image picker allows selecting an image from any space, as well as any page within any space.
Alternatively, you can use the Unsplash tab to select one of over 3 million free high-resolution images.
If you want to use an image hosted elsewhere, you can also paste the url directly into the image url field within the Link tab.
Testimonial Message Settings
The Testimonial Message drawer allows you to change the actual testimonial message and related styling.
Setting | Description |
|---|---|
Testimonial Text | Enter the actual text you want to show for the testimonial message. |
Text Padding | Control the spacing on the left/right and top/bottom of the text. This can be useful when the testimonial text has a border and background color, so the text doesn't run up against the edges. |
Border | Give your testimonial message a line border around the text. Set the color for the border using the color swatch. Use the size controls to adjust border thickness and corner radius. This allows you to highlight the message in different ways. When combined with the message background, and the border radius, you can create effects like a speech bubble for example. |
Background Color | Give the testimonial message itself a background color using the color swatch. This is optional and can be enabled/disabled using the toggle switch. |
Testimonial Customer/User Settings
Presumably, each Testimonial is given by a person. The Testimonial Customer/User drawer allows you to change the content and visuals for the person that left the testimonial.
Setting | Description |
|---|---|
Person Name | This is the name of the customer that left the testimonial. |
Person Name: Color | Give some color to the customer name text using the color swatch. |
Person Name: Text Size | Control how large the customer name appears using the size controls. |
Person Title | Enable/disable this optional setting to define the person’s title or job title which will appear below the name. |
Person Title: Color | Pick a color for the customer title text using the color swatch. |
Person Title: Text Size | Control how large the customer title appears using the size controls. |
Avatar Layout | Control whether the image and the text for customer (name and title) show stacked (the image above the text, or flat (the image next to the text). |
Horizontal Align | Control whether the image and text are aligned left, center, or right. |
Avatar Position | Control whether the customer information (image + text) shows above or below the testimonial text. If it shows "outside", in this case, the image goes beyond the borders of the testimonial |
Background Color | Enable/disable this optional setting to change the background color of the customer information using the color swatch. |
Border Color | Enable/disable this optional setting to change the border color around the customer information using the color swatch. |
Border Width | Add a border around the customer information. Adjust the thickness using the size controls. |
Border Radius | Change whether the edges of the border around the customer information is squared or rounded. Use the intensity controls to adjust the radius size. |
Customer Image Settings
The button visuals drawer allows you to change the visual settings of the button.
Setting | Description |
|---|---|
Image | Enable/disable this optional setting to select an avatar image for the customer that left the testimonial using the toggle button. Click on the Choose attachment field for options on which image to use. |
Image Style | Decide whether the avatar image shows as a circle or a square. |
Image Size | Change the size of the image to make it more or less prominent using the size controls. |
Image Border Size | Enable/disable this optional setting to add a border around the avatar image using the toggle button. Use the size controls to change the thickness of the border around the image. |
Border Color | Change the color of the border around the image using the color swatch. |
How to Edit the Testimonial Macro
To edit a Testimonial in a page, hover over the testimonial macro, and then click on the macro handle. Finally, click on the edit icon on the toolbar that appears.
This will launch the Configuration dialog, with the Advanced Config tab active.
Can I resize the panel?
The testimonial is a "block" macro, similar to the Confluence Divider, or Panel macro.
You can change the width of the testimonial between "center", "wide", and "full width".
Compatibility with Other Macros
The Simple Testimonial macro is compatible with most built-in Confluence macros that allow you to place other block-level elements inside of it.
This means, you can put a Testimonial into a Columns/Layout macro, or a table.