# Installing the Add-In

This article shows a MyGeotab Administrator how to install the FleetFusion Geotab Add-In so that the **FleetFusion** menu appears in MyGeotab for your users.

> **Permissions:** Only a MyGeotab Administrator with rights to manage system add-ins can install the FleetFusion Add-In. Standard MyGeotab users do not need to perform any installation steps.

## Before you begin

Before you start, make sure you have:

* Administrator access to your MyGeotab database.
* The FleetFusion `configuration.json` file. Request this from FleetFusion support at <support@fleetfusion.co.uk> if you do not already have it.
* A FleetFusion Organisation that matches your MyGeotab database. Each MyGeotab user who needs the add-in must also have a FleetFusion user account in this Organisation.

> **Important:** Users who do not have a matching FleetFusion account see an authentication error when they open the add-in. Provision FleetFusion accounts for the relevant users before rolling the add-in out widely.

## Steps

To install the add-in:

1. Sign in to MyGeotab as an Administrator.
2. Go to **Administration > System... > System Settings**.
3. Select the **Add-Ins** tab.
4. Click **New Add-In**.
5. Open the FleetFusion `configuration.json` file in a text editor and copy its full contents.
6. Paste the contents into the configuration field in MyGeotab.
7. Click **OK** to validate the configuration.
8. Click **Save** on the System Settings page to apply the change.

> **Tip:** Keep a copy of the `configuration.json` file somewhere safe. You need it again if you ever uninstall and reinstall the add-in, or roll it out to a second MyGeotab database.

## What happens next

After you save, MyGeotab loads the add-in configuration and adds a new top-level **FleetFusion** menu to the sidebar. The menu has ten entries: **Dashboard**, **Vehicles**, **Drivers**, **Maintenance**, **Media**, **Coaching**, **Documents**, **Work Queue**, **Workshop**, and **Settings**.

You may need to refresh MyGeotab or sign out and back in for the menu to appear.

## Verifying the installation

To check that the add-in is working:

1. Refresh MyGeotab in your browser.
2. Confirm that **FleetFusion** appears in the sidebar.
3. Click **FleetFusion > Dashboard**.
4. Confirm that the dashboard loads without an authentication error.

If the dashboard loads and shows your fleet data, the installation is complete.

## If something goes wrong

The most common installation issues are:

* **The FleetFusion menu does not appear.** Refresh MyGeotab or sign out and back in. If it still does not appear, re-open the add-in entry under **Add-Ins** and check that the configuration was saved.
* **Users see an authentication error.** The user does not yet have a FleetFusion account in the matching Organisation. Provision the user in FleetFusion, then ask them to retry.
* **The add-in loads a blank page.** The browser may be blocking third-party storage. See [How Authentication Works](/geotab-add-in/reference/how-authentication-works.md) for details.

For anything else, contact <support@fleetfusion.co.uk>.

## Related articles

* [What Is the FleetFusion Geotab Add-In?](/geotab-add-in/getting-started/what-is-the-geotab-addin.md)
* [Signing In](/geotab-add-in/getting-started/signing-in.md)
* [How Authentication Works](/geotab-add-in/reference/how-authentication-works.md)
* [Navigating the Add-In](/geotab-add-in/getting-started/navigating-the-addin.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fleetfusion.ai/geotab-add-in/getting-started/installing-the-addin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
