---
title: Widgets
description: "How public embeds publish reviews, projects, and maps."
---

Widgets are public embed configurations. Each widget has a UUID, name, type, location, filters, and minimum rating.

## Types

| Type | Public route behavior |
| --- | --- |
| `map` | Loads map CSS, widget JSON, Radar/Google Maps bridge script, and map markers. |
| `project-gallery` | Injects server-rendered gallery HTML into the host page. |
| `review-feed` | Injects server-rendered review-feed HTML into the host page. |

## Creating A Widget

1. Open `/admin/widgets`.
2. Create a widget and give it a clear internal name.
3. Choose the type.
4. Assign a location.
5. Set the minimum rating.
6. Save the widget.
7. Copy the embed script for `/widget/{widget}/embed.js`.

## Embed Route

Use this script on a public website:

```html
<script src="https://review-manager.test/widget/{widget}/embed.js" async></script>
```

Replace `{widget}` with the widget UUID.

## Readiness Checklist

| Widget | Required source data |
| --- | --- |
| Map | Location coordinates and project geolocation. |
| Project gallery | Projects with media and qualifying linked reviews. |
| Review feed | Reviews with text and rating at or above the widget minimum. |

<Warning>
Map marker coordinates are intentionally skewed slightly before display so public maps do not expose exact customer addresses.
</Warning>