This is the full developer documentation for ReviewForest Help Center
# Getting Started
> New to ReviewForest? Learn how to set up your account and start planting trees.
[Language settings at ReviewForest ](/getting-started/language-settings-at-reviewforest/)Set your app language, communication language, and how widgets display for end customers. Each team member picks their own without affecting others.
[How to sign up for ReviewForest ](/getting-started/how-to-sign-up-for-reviewforest/)Set up your account in six steps — from connecting your business and choosing your planting project to starting your own review forest.
[I can't find my business ](/getting-started/i-cant-find-my-business/)Your business doesn't show up during sign-up? Make your address publicly visible in Google My Business, or sign in directly with GMB.
[Apply a voucher during activation ](/getting-started/apply-a-voucher-during-activation/)Enter your voucher code in the checkout window and see the discount instantly in the summary before you complete your ReviewForest subscription.
# Install a ReviewForest Widget
> Pick your website platform and follow the step-by-step guide to add a ReviewForest widget in minutes.
Install the ReviewForest widget on your platform — pick yours below.
[WordPress ](/widgets/how-to-integrate-a-widget-in-wordpress/)Add widgets using the Insert Headers and Footers plugin, no theme editing needed.
[Shopify ](/widgets/how-to-integrate-a-widget-in-shopify/)Paste the widget code into your theme.liquid file before the closing body tag.
[Wix ](/widgets/install-reviewforest-widgets-on-wix-websites/)Connect ReviewForest to your Wix site in about five minutes using an HTML Embed block.
[Squarespace ](/widgets/how-to-add-widgets-to-squarespace/)Add widgets in a fixed spot or as a floating badge, with a video walkthrough.
[Jimdo ](/widgets/how-to-integrate-a-widget-in-jimdo/)Paste the widget code into a Jimdo Widget/HTML element in a few clicks.
[Joomla ](/widgets/how-to-integrate-a-widget-in-joomla/)Drop widgets into Joomla using a Custom HTML module and choose which pages they appear on.
[Shopware 6 ](/widgets/reviewforest-widgets-in-shopware-6-einbinden/)Add all 7 widgets via Shopping Experiences or globally in the footer through a child theme.
[Strato ](/widgets/how-to-add-reviewforest-widgets-to-strato/)Embed widgets on Strato as a floating overlay via the tracking code, or fixed in place.
## Working in a code editor?
[Section titled “Working in a code editor?”](#working-in-a-code-editor)
Your platform isn’t listed, or you’d rather not copy and paste at all? If you build your site in code, an AI coding agent can do the whole thing for you.
[AI coding agent ](/widgets/install-widgets-with-an-ai-coding-agent/)Install our skill, then let Claude Code, Cursor, Codex or Copilot place the widget for you — or build a custom design from our API.
# Install ReviewForest widgets on Wix websites
> Connect ReviewForest to your Wix site in about five minutes using an HTML Embed block, with both code snippets needed to display your reviews.
Adding the ReviewForest widgets to your Wix.com website is really easy. You need about **5 minutes** to connect it.
[Video Guide: Install ReviewForest on your Wix website](https://www.youtube-nocookie.com/embed/hoJHtqDmiOg)
1. Go to *Edit Site* on Wix.com
2. Choose where you want to add the widget and use the *+* Symbol to add a new section
3. Choose *HTML Embed*
4. Choose your preferred design style
5. Click the *HTML* label with the pen icon
6. Copy & paste the code from the widget code from your [ReviewForest web app](https://app.reviewforest.org/forest-widget) to the fiel that says “Paste your code”
Note
You have to insert *both* codes
7. You may want to play around with the width & height options 8 ) Click on *Publish*
# Install widgets with an AI coding agent
> Let Claude Code, Cursor, Codex or another AI coding agent install your ReviewForest widget. One command adds our skill, then your agent does the rest.
If you work on your website in a code editor — React, Vue, Next.js, plain HTML, or a WordPress or Shopware theme — you don’t have to follow a click-by-click guide. We publish a **skill** that teaches your AI coding agent how ReviewForest widgets work. Install it once, then tell your agent what you want in plain language.
It works with Claude Code, Cursor, Codex, GitHub Copilot and dozens of other agents, because it follows the open [Agent Skills](https://agentskills.io) standard.
Not working in a code editor?
If you manage your site through a builder like Wix, Squarespace, Jimdo or Strato, there’s nothing to install — pick your platform in the [installation guides](/widgets/install/) instead.
## Two ways your agent can do it
[Section titled “Two ways your agent can do it”](#two-ways-your-agent-can-do-it)
The skill covers both, and your agent will ask which one you want.
| | Widget embed (recommended) | Custom rendering via API |
| ------------------------ | --------------------------------------------------- | ----------------------------------------------------------------- |
| **What happens** | Your agent places our ready-made widget on the page | Your agent fetches your review data and builds its own components |
| **Design** | Configured in your ReviewForest dashboard | Fully yours, in your own framework |
| **Loads our JavaScript** | Yes | No |
| **You need** | A widget ID | An API key with the **Website-Widgets** scope |
Start with the widget embed. Only go the API route if none of our 7 widgets fit the design you have in mind.
## Step 1: Install the skill
[Section titled “Step 1: Install the skill”](#step-1-install-the-skill)
Run this in your project folder:
```bash
npx skills add reviewforest/skills
```
It detects the agents you have installed and may ask where the skill should go, then writes it into that agent’s folder — `.claude/skills/` for Claude Code, `.agents/skills/` for Cursor and Codex, and so on. Because it lands in your project, you can commit it like anything else and your teammates get it too.
Want it available in every project on your machine instead? Add the global flag:
```bash
npx skills add reviewforest/skills --global
```
To pick up later changes, run `npx skills update`.
### Or skip the install
[Section titled “Or skip the install”](#or-skip-the-install)
If you’d rather not add a file to your repo, have the CLI generate the prompt instead:
```bash
npx skills use reviewforest/skills
```
That pulls the skill into a temporary folder and prints a prompt for you to paste into your agent. Add `--agent claude-code` (or another agent ID) and it launches the agent with that prompt already loaded.
## Step 2: Get your widget ID
[Section titled “Step 2: Get your widget ID”](#step-2-get-your-widget-id)
Create and customize a widget at [app.reviewforest.org/website-widgets/add](https://app.reviewforest.org/website-widgets/add) — pick the type, set the colors, choose which reviews to show. Already have one? Grab it from [your installed widgets](https://app.reviewforest.org/website-widgets/installed).
Copy the code it gives you. It looks like this:
Your widget code
```html
```
You can hand your agent the whole snippet, or just the ID from the `div` — it can rebuild the rest.
## Step 3: Tell your agent what you want
[Section titled “Step 3: Tell your agent what you want”](#step-3-tell-your-agent-what-you-want)
Now describe the result you’re after, and paste in the code from step 2:
* Testimonials
```plaintext
Add my ReviewForest testimonials carousel to the homepage, below the hero section:
```
* Floating badge
```plaintext
Add my ReviewForest review score badge to every page. It's configured as
a floating badge in the dashboard. Widget ID: YOUR-WIDGET-ID
```
* Custom design
```plaintext
Build a reviews section for the About page using the ReviewForest API
instead of the embed widget. Match the styling of our existing cards.
API key (Website-Widgets scope only): YOUR-API-KEY
```
You don’t need to explain the technical details. The skill already tells your agent:
* What all 7 widget types are, and which ones need a wide container (the testimonials carousel and the forest page widget look cramped in a narrow column)
* That the `
```
## Attribute Details
[Section titled “Attribute Details”](#attribute-details)
* **`data-inline-css`**: Apply CSS rules directly. Perfect for quick tweaks.
* Example: `data-inline-css=".promo__ttl {color: #ff69b4; font-weight: bold;}"`
* **`data-css-url`**: Link to an external CSS file. Ideal for comprehensive styling.
* Example: `data-css-url="https://your-website.com/path/to/custom-styles.css"`
## Use cases
[Section titled “Use cases”](#use-cases)
### Hiding the widget menu
[Section titled “Hiding the widget menu”](#hiding-the-widget-menu)
To hide the widget menu, the line data-inline-css=“.header {display: none}” can be inserted into the widget snippet. Example:
```html
```
## Important Notes
[Section titled “Important Notes”](#important-notes)
1. Ensure the external CSS file path is correct and accessible from your HTML file location.
2. The widget content is encapsulated within a Shadow DOM, so custom styles applied via these attributes will only affect the widget itself.
3. When using `data-css-url`, make sure your server allows Cross-Origin Resource Sharing (CORS) if the CSS file is hosted on a different domain.
4. For complex layouts or responsive designs, we recommend using the external CSS file approach.
By utilizing these attributes, you can tailor the appearance of your widget to seamlessly integrate with your website’s design and meet your specific style requirements.
Need further assistance? Don’t hesitate to reach out to our support team!
# How to integrate a widget in Jimdo
> Paste the ReviewForest widget code into a Jimdo Widget/HTML element in a few clicks and start showing your reviews and planted trees on any page.
In the following, we will show you how to integrate a widget in Jimdo.
1. To add a widget to Jimdo, first visit our website and log in.
2. Click on “Widgets” on the left and then on “Review Widget” or “Forest Widget”. Select a widget and click “Install”.
3. Choose between “Floating widget” and “Badge widget” as well as the position (top left, bottom right …) and copy the HTML code to the clipboard (attention: there are two HTML codes for the “forest widget”).
4. Now log in to Jimdo and call up the desired subpage.
5. Click on “Edit”, then on “Add element” and “Additional elements”.
6. Select “Widget / HTML”.
7. Here you can insert the HTML code(s) we have generated.
8. Finally click on “Save”. If the widget is not displayed immediately, reload your browser once.
# How to integrate a widget in Joomla
> Drop ReviewForest widgets into Joomla using a Custom HTML module, choose exactly which pages they appear on, and watch your reviews and trees go live.
In order to integrate a widget in Joomla, first you need to copy the widget HTML-Codes provided by ReviewForest. If you already done so you can skip the next four steps and directly go to step five.
1. Visit and login into your account.
2. Choose “Widgets” within the left hand menu or directly visit . You can choose between “Review Widget” and “Forest Widget”. For this article we go through the steps in order to integrate the Forest Widget. But the necessary steps will work with the Review Widget as well.
3. After you have chosen one of the widgets, you need to click on the button “Install” which you find on the right side of the widget preview.
4. Now a window should show up. At first copy the upper HTML-Code but leave the window open as you will need the second HTML-Code later as well.
5. Within a new Browser window, go to your Joomla website. Here you need to create a “HTML-Code Module”. Within your Control Panel navigate to “Extensions” and then to “Module manager”.
6. Click on “New” in order to create a new module and choose “Custom HTML”
7. Define a name and make a choice about the position in which the widget should be shown on your Website. Now you can insert the already copied HTML-Code. In pressing enter you’ll create a new line where you can insert the second HTML-Code. For this go back to your ReviewForest account copy the second code and insert it on Joomla behind the first HTML-Code.
8. Now you can use the visual mode or take the path via clicking on “Tools” and then “Source Code” to see the HTML-Code.
9. In a following step you can open “Menu assignment” and specify those pages on which the HTML Module should be shown.
10. Finally don’t forget to save your changes. In refreshing your website afterwards you can check out the outcome.
# How to integrate a widget in Shopify
> Paste the ReviewForest widget into your Shopify theme.liquid file before the closing body tag and show reviews across every page of your store.
In the following, we will show you how to integrate a widget in Shopify.
1. First of all, visit our website and log in.
2. Click in the menu on the left on “Widgets” and then on “Review Widget” or “Forest Widget”. Select a widget and click “Install”.
3. Choose between “Floating widget” and “Badge widget” as well as the position (top left, bottom right …) and copy the HTML code to the clipboard (attention: there are two HTML codes for the “forest widget”) .
4. Go to Shopify admin panel and log in to the backend. Then click on “Online Store”, then on “Actions” on the right and select “Edit code” in the drop-down menu.
5. Click on “Themes” on the left and under “Layout” on “theme.liquid”.
6. In the window on the right, into the bottom before the ` ` tag, you can now copy the ReviewForest HTML code you copied at the beginning.
7. Click on “Save”.
Working on your theme locally?
If you edit your Shopify theme in code rather than in the browser editor, an AI coding agent can place the widget for you — see [Install widgets with an AI coding agent](/widgets/install-widgets-with-an-ai-coding-agent/).
# How to integrate a widget in WordPress
> Add ReviewForest widgets to WordPress in minutes using the Insert Headers and Footers plugin, no theme editing or coding needed to get started.
In the following, we will show you how to integrate a widget in WordPress.
1. First of all, visit our website