Testimonials are in the menu Testimonials. Each has a title, a contact from the contacts, a rating in stars, a source and text. Visitors see them after publishing wherever a block shows them. The permission is in the area Testimonials of a role.
Series 6: Extensions Chapter 2 of 10
Testimonials: maintaining ratings and quotes
This only exists with the extension “Testimonials”. If it is missing from your administration, the extension is not installed.
In short
A testimonial is a quote with a rating, for example from an email or the guest book. The extension SuluTestimonialsBundle collects them in a list of their own and shows them on pages. In the admin the menu is called Testimonials.
The images show three invented testimonials of the example website. Whether you see the menu depends on your role.
Helpful first: 1.9 Draft, preview, publish 1.8 Contacts and forms
Step 1 of 11 Open the list
In the main menu, click Testimonials. Each testimonial has a row with Title, Contact, Rating, Status and language. Contact is the person from the contacts.
Rating appears twice: as a colored bar and as stars with a number. A green dot at Status means: published. Move the mouse over a row. A pen icon appears in front of it that opens the testimonial.
Under Testimonials there is also the entry Settings. It applies to the single view of a testimonial: Display Header, Display Default Hero and Display Breadcrumbs. The example website shows testimonials only in lists on pages.
Step 2 of 11 Open a testimonial
The form has six required fields:
- Title: an internal name that appears in the list, for example “From Max Muster”.
- URL: the address of the single view. You choose a page and an ending. The ending is suggested.
- Contact: the person from the contacts. Show Contact shows the name of the person (default: on), Show Organisation their organization (default: off).
- Rating: the stars.
- Source: where the testimonial comes from, at most 255 characters.
- Text: the testimonial word for word.
Further tabs are SEO, Excerpt & Taxonomies, Settings, Automation and Insights.
Step 3 of 11 Choose the rating
Click the field Rating. The selection has six rows from 0/5 to 5/5, each with stars. A check mark shows the chosen value.
The example website works with five stars. According to the documentation there is also a scale up to 10. Developers set it when installing.
Step 4 of 11 Create a new testimonial
In the list, click Add and fill in the required fields. At URL you choose a page, for example About us, and enter the ending. Rating is first set to Please choose.
The person at Contact must already be in the contacts. Create them there if they are missing.
Step 5 of 11 Choosing the template
The toolbar shows the name of the template, first Basic. A click on it opens the selection with Basic and Extended.
The template Extended additionally has Date (a required field) with the switch Show Date. In the area Optional Fields, Link and Image are added. At Link an example address is first entered. Replace it or empty the field.
Step 6 of 11 Save and publish
As soon as you change something, Save becomes available. The arrow next to it opens a menu with Save as draft, Save and publish and Publish. Visitors only see a testimonial once it is published.
You take a published testimonial back through the menu with the pen icon: Set to unpublished.
Step 7 of 11 Show it on a page
A testimonial appears wherever a block shows it. In the example website that is the block Collection on the page About us. Content Type is set to Testimonials, Selection is set to Manual: the testimonials are chosen one by one.
With Filtered you pick the testimonials by a filter, for example by a tag.
Step 8 of 11 How visitors see it
Each testimonial is a card with quote, stars, name and source. With four out of five stars, the last star is gray.
Step 9 of 11 Change several testimonials at once
Check marks in the list unlock the menu Bulk actions. It has four actions: Publish, Unpublish, Copy locale and Delete. After Unpublish, Status shows a yellow dot.
Only roles with the permission for it see the menu. In the example website that is the role Admin, which is why the images come from it. The chapter Several entries at once: bulk actions explains all the actions.
Step 10 of 11 Assign the permission
The permission is assigned by whoever manages the user roles at your business, under Settings › User roles. Open the role and look for the area Testimonials. It has two rows: testimonials with five icons for view, add, edit, delete and live, and settings with two icons for view and edit. Live allows publishing.
Step 11 of 11 Installing it in your project
The extension is called SuluTestimonialsBundle. On Packagist it is at version 1.9.1 (as of October 22, 2026). It needs Sulu 3 and PHP 8.2.
- Install the package with the command below.
- Enter the bundle in
config/bundles.phpif Symfony Flex has not already done so. - Include the admin routes in
config/routes/sulu_admin.yaml. - Update the database schema. The README names
doctrine:schema:updatefor this. - Rebuild the admin:
npm installandnpm run buildin the folderassets/admin. - Give a role the area Testimonials.
The scale of the stars is in config/packages/sulu_testimonials.yaml under rating. max_value is 5 or 10 (default 5), default_value the preset value (default 3), use_star_symbols shows stars in the selection. Developers write the output on the website in Twig or with smart content. The exact lines are in the README on GitHub. The folder docs explains setup, rating and templates.
composer require manuxi/sulu-testimonials-bundle
If the SuluAdminExtrasBundle is installed, do not include the JavaScript of the testimonials bundle in addition. Both bundles register the field star_rating. If both are included, the admin breaks after login with the message “The key "star_rating" has already been used for another field”.
- 6.4Several entries at once: bulk actions Applies to: Extension “Bulk actions”
- 3.5Automatic lists with Smart Content