> ## Documentation Index
> Fetch the complete documentation index at: https://docs.remapdb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation troubleshooting

> Use this short guide to fix widget installation problems for both code install and WordPress plugin install.

Use this page when the widget is blank, missing, or not working on your live page.

If you have not run the full setup flow yet, start with [Installation checklist](/widget/installation/installation-checklist).

## Quick checks first

1. Open the live public page URL (not preview mode).
2. Confirm your website is added in Remapdb.
   * In Remapdb, click the [**Installation**](https://app.remapdb.com/widget/install) item in the main navigation.
   * In **Add allowed websites**, confirm the exact live website is listed.
3. Reload the page with a hard refresh (`Ctrl/Cmd + Shift + R`).

## If you installed with code

1. Open the page source or page builder HTML area.
2. Confirm the widget container exists (`<div class="rdb-widget">`).
3. Confirm the embed script exists on the same page (`embed.js`).
4. Confirm you only have one widget snippet on that page.
5. Save, publish, and test again.

## If you installed with WordPress plugin

1. In WordPress admin, click the **Plugins** item in the main navigation.
2. Click the **Installed Plugins** link.
3. Confirm Remapdb plugin status is active.
4. Click the **Pages** item in the main navigation.
5. Click the **Edit** link for the target page.
6. Confirm shortcode `[remapdb]` is present.
7. Click the **Update** button.
8. Open the live page and test again.

## If it works on one URL but fails on another

1. Check the exact website in the browser address bar.
2. Add that exact website in **Add allowed websites**.
3. Repeat for each different website or subdomain you use.

## If changes are not visible

1. In WordPress, click the **Plugins** item in the main navigation.
2. Click the **Installed Plugins** link and check if you use a speed/cache plugin.
3. If yes, click the **Settings** link for that plugin.
4. Click the **Clear cache** button or the **Purge cache** button.
5. If you also use hosting/CDN cache, clear it there.
6. Reload with a hard refresh and test again.

## Still blocked?

1. Open [https://app.remapdb.com/support](https://app.remapdb.com/support) or email [support@remapdb.com](mailto:support@remapdb.com).
2. Send:
   * Live page URL
   * Screenshot of **Add allowed websites**
   * Short note: code install or WordPress install
   * Screenshot of what you see on the live page

After support fixes the issue, go back to [Installation checklist](/widget/installation/installation-checklist) and run all checklist items again.

<Info>
  Need full setup steps?\
  Use [Code installation](/widget/installation/code-installation) for code setup and [WordPress plugin installation](/widget/installation/wordpress-plugin-installation) for plugin setup.
</Info>