--- title: "Widget Installation" canonical: "https://help.cartinuum.com/space/WC/4255481886/Widget%20Installation" format: markdown --- Cartinuum widgets can be used with ArcGIS Experience Builder in different ways, depending on how your organisation builds and hosts Experience Builder applications. Use this guide to choose the right installation option, install or enable the widget, and add the widget license. ## Choose an installation option | If you use | Choose this option | | --- | --- | | ArcGIS Enterprise Experience Builder | Install the widget using the ArcGIS Enterprise manifest option. | | Experience Builder Developer Edition | Download the widget code and copy it into your Developer Edition extensions folder. | | [Cartinuum Managed Experience Builder for ArcGIS Online](https://bgt-innovation.atlassian.net/wiki/spaces/WC/pages/4538204179) | Use the Managed Experience Builder option. Widgets are preinstalled; you only need the license. | ## Before you begin Before installing a widget: 1. Sign in to your [Cartinuum Extensions account](https://extensions.cartinuum.com). 2. Open **My Extensions**. 3. Locate the widget subscription. 4. Confirm that the widget is licensed for the ArcGIS Online or ArcGIS Enterprise portal where it will be used. 5. Confirm which Experience Builder environment you are using. ## Open the download menu From **My Extensions**, locate the widget and select **Download**. The download menu includes different options depending on the widget and your subscription. ![Download menu for a Cartinuum widget subscription showing ArcGIS Enterprise, Developer Edition, and Managed Experience Builder options.](media://5c587e72-45b2-4f67-bd47-76bf48c9c247) ## Option 1: ArcGIS Enterprise Experience Builder Use this option when you want to add a Cartinuum widget to the Experience Builder included with ArcGIS Enterprise. ### Install the widget 1. In the widget download menu, choose **ArcGIS Enterprise Experience Builder**. 2. Follow the prompts to copy the manifest link and download the license file. 3. In ArcGIS Enterprise: - 1. Navigate to the **Content** section. 2. Select **New Item** and choose the **Application** option. 3. For application type, select **Experience Builder widget**. 4. Paste the provided link into the **Manifest URL** field and click **Next**. 5. [OPTIONAL] Update the widget title and folder. 6. Click **Save**. 4. Confirm that the widget appears in Experience Builder. 5. Add the widget to your app. 6. Add the widget license in the widget settings. ### Notes - The widget must be compatible with the Experience Builder version included with your ArcGIS Enterprise deployment. - Widget licenses are tied to the ArcGIS portal for which they were issued. - If you move the widget to another portal, you may need a different license. ## Option 2: Experience Builder Developer Edition Use this option when you host and manage your own Experience Builder Developer Edition environment. ### Install the widget 1. In the widget download menu, choose **Experience Builder Developer Edition**. 2. Follow the prompts to download the license file and widget ZIP file. 3. Unzip the downloaded ZIP file. 4. Copy the widget folder into the Experience Builder Developer Edition widgets folder: ``` client/your-extensions/widgets/ ``` 5. Restart Experience Builder Developer Edition. 6. Confirm that the widget appears in the widget panel. 7. Add the widget to your app. 8. Add the widget license in the widget settings. ### Notes - Keep the widget folder structure intact when copying the widget into Developer Edition. - Restart the Experience Builder client after adding or updating widget files. - If the widget does not appear, check the browser console and Experience Builder logs for loading errors. ## Option 3: Managed Experience Builder for ArcGIS Use this option when your organisation subscribes to Cartinuum [Managed Experience Builder for ArcGIS](https://bgt-innovation.atlassian.net/wiki/spaces/WC/pages/4538204179). In Managed Experience Builder, Cartinuum widgets are already installed in the hosted builder environment. You do not need to upload widget code or register a manifest. ### Enable the widget 1. In the widget download menu, choose **Managed Experience Builder for ArcGIS**. 2. Follow the prompts to download the license file. 3. Open your Managed Experience Builder environment. 4. Add the widget to your app. 5. Add the widget license in the widget settings. 6. Save, publish, and deploy the app. ### Notes - Managed Experience Builder handles widget installation and hosting. - You still need a valid license for each licensed widget. - Existing deployed apps are not automatically updated when a widget is updated in the builder. Publish and redeploy the app when you want end users to receive widget changes. ## Add the license Cartinuum widgets require a license file, downloaded from your Cartinuum Extensions site. In Experience Builder: 1. Add the widget to the app. 2. Open the widget settings. 3. Find the **License Settings** section. 4. Drag and drop or upload the license file. 5. Confirm that the widget accepts the license. 6. Save the app. ![License settings section in an Experience Builder widget showing where to add the Cartinuum license.](media://44f1cbe2-8c33-4ca6-8792-436036f8e584) ## About widget licenses Widget licenses are issued for a specific ArcGIS Online or ArcGIS Enterprise portal. This means: - A license issued for one portal cannot be used with another portal. - Production and non-production portals may require separate licenses. - If your Managed Experience Builder subscription is moved to a different portal, widget licenses may need to be updated. - If a widget reports a license error, confirm that the license matches the portal used by the app. ## Update a widget The update process depends on your installation option. ### ArcGIS Enterprise Experience Builder Updates are published automatically by the Cartinuum team. The manifest link will point to the latest files. ### Experience Builder Developer Edition 1. Download the updated widget ZIP. 2. Back up the existing widget folder if required. 3. Replace the widget folder in: ``` client/your-extensions/widgets/ ``` 4. Restart Experience Builder Developer Edition. 5. Test the app. 6. Rebuild and redeploy your Experience Builder application if required. ### Managed Experience Builder for ArcGIS Cartinuum manages widget updates in the builder environment. To pick up changes in a deployed app, you will need to redeploy the app. See the [https://bgt-innovation.atlassian.net/wiki/spaces/WC/pages/4538138723](https://bgt-innovation.atlassian.net/wiki/spaces/WC/pages/4538138723) article for more information. ## Troubleshooting ### The widget does not appear in Experience Builder Check that: - You chose the correct installation option. - The widget is compatible with your Experience Builder version. - The Developer Edition client app has been restarted after copying the widget. - The widget folder was copied to the correct location. - The browser console does not show widget loading errors. ### The widget appears but does not work Check that: - The widget has a valid license. - The app has the required Map widget or data source. - Required layers, services, or third-party API keys have been configured. - The current user has permission to access required ArcGIS content. ### The widget reports a license error Check that: - The license was added in the widget settings. - The license is for the correct widget. - The license is for the same ArcGIS portal used by the app. - The license has not expired.