Customize your widget's colors and style
With Widget V2 you can style your badge, mini and carousel widgets to match your website. There are two ways to do it: settings in the dashboard, no code needed, or CSS for developers who want full control.
Customize in the dashboard (no code)
Section titled “Customize in the dashboard (no code)”-
Open Website widgets, switch to the Your widgets tab and click the gear icon in the row of a V2 widget. For a new widget, the same settings appear while you create it.
-
In step 1, choose Light or Dark under Appearance and pick which elements the widget shows.
-
Click Next to get to step 2, Appearance. Here you set colors and shapes, grouped in sections you open with a click. For the review score badge and the 2 in 1 badge, these are:
Widget: Background, Text, Secondary text, Border, Border width and Widget corners.
Button: Background, Background on hover, Text, Border, Border width and Button corners.
Stars: Active star and Inactive star.
Drawer (opens on click): the panel that opens when a visitor clicks the badge, with its width, scrollbar, dividers, muted text, links and tooltips.
The other widgets show only the sections that fit them. The tree counter badge has Widget and Button, the carousel has Widget, Button and Stars, and the mini tree counter has a few text colors.

-
Watch the preview on the right change as you go. Then click Next until the last step and Update widget. Your website shows the new look the next time the page loads.
Customize with CSS (for developers)
Section titled “Customize with CSS (for developers)”V2 widgets offer a set of CSS custom properties (CSS variables) for styling. Set them on the widget’s own div on your website, the element with the reviewforest-app- class:
<div class="reviewforest-app-xxxxxxxx"></div>
<style> .reviewforest-app-xxxxxxxx { --rf-bg: #ffffff; --rf-text: #1a1a1a; --rf-primary: #2f8f4e; /* button background */ --rf-primary-text: #ffffff; /* text on the button */ --rf-radius: 8px; --rf-font: "Inter", sans-serif; }</style>Replace xxxxxxxx with your widget’s ID, the part after reviewforest-app- in the code from your dashboard. You only need to set the properties you want to change. Everything else keeps its default.
Set each value in one place only. A color you set in the dashboard wins over the same variable in your CSS. Variables set on a parent element, such as body, don’t reach the widget.
Colors, text and shape
Section titled “Colors, text and shape”Each widget only uses the variables that fit its parts. The mini tree counter, for example, only uses the font, the text colors and the corner radius.
| Variable | Controls |
|---|---|
--rf-primary |
Button / call-to-action background |
--rf-primary-text |
Text on the button |
--rf-primary-hover |
Button background on hover |
--rf-bg |
Background color |
--rf-text |
Main text color |
--rf-text-secondary |
Secondary text color |
--rf-text-muted |
Muted / meta text color |
--rf-border |
Border color |
--rf-border-subtle |
Divider / hairline color |
--rf-radius |
Corner roundness (container) |
--rf-radius-button |
Corner roundness (buttons) |
--rf-button-border |
Button border color (badges and carousel) |
--rf-button-border-width |
Button border width (badges and carousel) |
--rf-font |
Font family |
--rf-font-size |
Base font size |
--rf-focus |
Focus-ring color (keyboard navigation) |
--rf-link |
Link color |
--rf-link-hover |
Link color on hover |
--rf-star-filled |
Filled star color |
--rf-star-empty |
Empty star color |
--rf-warning-bg |
Warning banner background |
--rf-warning-text |
Warning banner text |
Badge widgets only
Section titled “Badge widgets only”| Variable | Controls |
|---|---|
--rf-shadow |
Badge drop-shadow |
--rf-border-width |
Badge border thickness |
Review drawer (opens on click)
Section titled “Review drawer (opens on click)”| Variable | Controls |
|---|---|
--rf-badge-padding |
Inner padding of the summary card at the top of the drawer |
--rf-badge-gap |
Spacing inside that summary card |
--rf-badge-hover |
Background of that summary card on hover |
--rf-drawer-width |
Drawer panel width |
--rf-drawer-gap |
Spacing between drawer sections |
--rf-drawer-shadow |
Drawer drop-shadow |
--rf-drawer-scrollbar |
Scrollbar color |
--rf-tooltip-bg |
Tooltip background |
--rf-tooltip-text |
Tooltip text color |
Carousel only
Section titled “Carousel only”| Variable | Controls |
|---|---|
--rf-dot-active |
Active pagination dot color |
--rf-dot-inactive |
Inactive pagination dot color |
The carousel sets the width and spacing of its cards and the size of its dots itself, depending on the available width. You can’t change those with variables.
How the widget stays separate from your page
Section titled “How the widget stays separate from your page”V2 widgets render inside an isolated container (a Shadow DOM). Your settings and CSS variables only style the widget, and the widget’s own styles never change the rest of your website.