Skip to content

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.

  1. 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.

  2. In step 1, choose Light or Dark under Appearance and pick which elements the widget shows.

  3. 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.

    Step 2 Appearance, showing the widget color controls and a live preview

  4. 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.

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.

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
Variable Controls
--rf-shadow Badge drop-shadow
--rf-border-width Badge border thickness
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
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.

Open your widgets