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

# WordPress plugin installation

> Install the official Remapdb WordPress plugin and connect it to your widget safely.

## Before you start

Confirm you have WordPress admin access.

* Open your WordPress admin login page and sign in (for example: `https://www.yourwebsite.com/wp-admin`).
* Click the **Users** item in the main navigation.
* Click the **Plugins** item in the main navigation.
* If you can open both pages and you can see the **Add user** button, your access is usually correct.
* If you cannot open these pages, ask the website owner to give you **Administrator** role.

## Method 1: Install from the plugin .zip file

<Steps>
  <Step title="Open the official plugin page">
    Open the official Remapdb WordPress plugin page: [https://wordpress.org/plugins/remapdb/](https://wordpress.org/plugins/remapdb/).
  </Step>

  <Step title="Download the official plugin zip">
    A new tab opens the official Remapdb WordPress plugin page. Click the **Download** button to get the plugin `.zip` file.
  </Step>

  <Step title="Open WordPress plugin upload">
    In WordPress admin, click the **Plugins** item in the main navigation, then click the **Add plugin** link.
  </Step>

  <Step title="Upload the zip file">
    Click the **Upload plugin** button near the top of the page, choose the downloaded plugin zip, and install it.\
    Do not unzip/unarchive the file before uploading.
  </Step>

  <Step title="Activate the plugin">
    After installation finishes, click the **Activate** button.
  </Step>
</Steps>

After successful activation, the Remapdb plugin appears in the main WordPress navigation.

## Method 2: Install directly from WordPress plugin search

<Steps>
  <Step title="Open Add Plugin page">
    In WordPress admin, click the **Plugins** item in the main navigation, then click the **Add plugin** link.
  </Step>

  <Step title="Search for the plugin">
    In the plugin search box, type **remapdb**.
  </Step>

  <Step title="Install the official plugin">
    Find the official Remapdb plugin and click the **Install now** button.
  </Step>

  <Step title="Activate the plugin">
    When installation completes, click the **Activate** button.
  </Step>
</Steps>

After successful activation, the Remapdb plugin appears in the main WordPress navigation.

## Connect the plugin to your Remapdb account

1. In WordPress admin, click the **Remapdb** item in the main navigation.
2. Click the **Settings** tab.
3. Click the **Connect remapdb** button.
4. Follow the on-screen instructions to complete connection.

The connection step should be done by you, because you must enter your own Remapdb account credentials.

## Add the widget to a page with shortcode

After the plugin is connected, place the widget on the page where you want it to appear.

Use this shortcode:

```bash theme={null}
[remapdb]
```

Most websites add this inside a **Shortcode** block.

### Block editor (Gutenberg)

1. Open the page in WordPress editor.
2. Click the **Add block** button.
3. Search for and select the **Shortcode** block.
4. Paste `[remapdb]` in the block.
5. Click the **Update** button or click the **Publish** button.

### Elementor

1. Open the page in Elementor editor.
2. Click the **Widgets** tab.
3. Search for **Shortcode**.
4. Drag and drop the **Shortcode** widget to the desired location on the page.
5. Paste `[remapdb]` in the shortcode text area.
6. Click the **Apply** button to apply the changes or click the **Update** button if you are editing an existing page.

### Classic editor

1. Open the page in WordPress editor.
2. Paste `[remapdb]` in the content where the widget should appear.
3. Click the **Update** button or click the **Publish** button.

## Verify on live website

1. Open the live page URL.
2. Confirm the widget loads and accepts vehicle selections.
3. Submit a test quote and verify email delivery.

## Common issues

1. Domain not added in allowed websites.
   * In Remapdb, click the [**Installation**](https://app.remapdb.com/widget/install) item in the main navigation.
   * In **Add allowed websites**, make sure the exact website is saved.
   * If needed, follow [Add website in Remapdb](/widget/installation/code-installation#step-1-add-website-in-remapdb).
   * Open your live page again and test.
2. Plugin is active, but shortcode/block is missing from the page.
   * In WordPress, click the **Pages** item in the main navigation.
   * Click the **Edit** link on the page where the widget should appear.
   * Add a **Shortcode** block.
   * Paste `[remapdb]`.
   * Click the **Update** button.
   * Reload the live page and test.
3. An old saved version of the page is still loading.
   * In WordPress, click the **Plugins** item in the main navigation.
   * Click the **Installed Plugins** link and check if you use a speed/cache plugin.
   * If you use one, click the **Settings** link for that plugin, then click the **Clear cache** button or the **Purge cache** button.
   * If you do not use one, skip this step and continue.
   * If your hosting panel or CDN also has cache, clear it there too.
   * Reload the page with a hard refresh (`Ctrl/Cmd + Shift + R`) and test again.
4. Theme or page builder removes shortcode output.
   * Click the **Edit** link on the same page and move `[remapdb]` to a simple content area first.
   * Test with a basic **Shortcode** block instead of advanced theme blocks.
   * If it works in a simple block, keep it there or ask your theme support how to allow shortcode rendering in your current block type.

## Need help from support

If you have any issue, click the **Support** tab in the plugin and click the **Open Remapdb Support** button to see official support channels.

You can also contact us directly:

1. Support page: [https://app.remapdb.com/support](https://app.remapdb.com/support)
2. Support email: [support@remapdb.com](mailto:support@remapdb.com)

When contacting support, describe the issue clearly and include screenshots when possible.