home User Guide Getting Started Help Center Documentation Community Training Certification
Looker keyboard_arrow_down
language keyboard_arrow_down
Using the Looker Marketplace

New blocks, applications, visualizations, and plug-ins are announced in the Looker Release Notes or the changelog for each release. You can access the changelog from the Looker Release Notes page.

The Looker Marketplace is a central location for finding, deploying, and managing many types of Looker content, such as Looker Blocks, applications, visualizations, and plug-ins.

The Looker Marketplace Labs feature is enabled by default. To deploy blocks from the Looker Marketplace, Looker admins must enable the Local Project Import Labs feature.

Accessing the Looker Marketplace

To enable users to access and install content from the Looker Marketplace, a Looker admin must enable the Marketplace and Local Project Import Labs features.

All users can access the Looker Marketplace by clicking the shop icon on the Looker menu bar. Users must have develop, manage_models, and deploy permissions to install packages from the Marketplace.

The Marketplace homepage shows popular Looker applications and Looker Blocks:

In the main menu on the left side of the page, you can select one of several options to see the full library of tool types. These types include:

To use an installed visualization, make sure that you have enabled Looker cookies in your browser.

Some applications, like the Looker Data Dictionary, are extensions built using the Looker extension framework that require the Extension Framework Labs feature to be enabled for installation from the Looker Marketplace.

Once a package is installed, it can be accessed from the Applications & Tools page, accessible from the Browse menu and the left sidebar in Browse:

From there, you will see either the application’s homepage or a list of pre-built dashboards and Explores that use the installed model and associated data. Although all users will be able to view the Applications and Tools page, users will only be able to access the installed packages based on models to which they have been granted permissions to access.

See the Customizing Looker Marketplace Blocks documentation for information on customizing blocks you have installed from the Marketplace.

The applications, models, and plug-ins available in the Marketplace are defined in a server separate from the Looker instance. This allows the Marketplace data to be updated at any time. Looker instances running in the cloud automatically get access to the Marketplace data server.

Customer-hosted Looker instances may require additional configuration to access the Marketplace data. The server running the Looker instance will need to be configured to access the public internet server running at the URL https://marketplace-api.looker.com/.

Installing a Tool from the Marketplace

Customer-hosted deployments using clustered instances must set up a shared (network) file system to install applications or tools from the Looker Marketplace.

The installation process varies, depending on the tool you are installing. Applications and some models, for example, have the option to connect to your source database and create a new, Looker-managed database that is automatically configured to be compatible with the requirements of that data source. Most plug-ins, however, require some minimal configuration information to install successfully.

The procedure below shows all the possible installation options; however, depending on the tool you are installing, you may only see a subset of the steps below.

To install a tool from the Looker Marketplace:

  1. From the Marketplace main menu, navigate to the tool you want to install, and click its tile:

    Looker displays the tool’s installation page. The installation page shows a short description of the tool and any needed information about installing and using the tool:

  2. Click Install or Install Free Trial.

  3. Looker displays pages asking you to accept the tool’s license agreements and the Looker permissions required by the tool. If you want to accept the license agreements and permission requests, click Accept on these pages.

  4. If you are installing an application or a model that requires a data source, Looker asks if you already have a connection to the database:

    • Select Yes if you have already connected Looker to the database where your relevant data is stored.
    • Select No if you would like the installation process to create a database connection for you.

    After you indicate whether you already have a connection to your database, click Next.

  5. If you are installing an application or a model that requires a data source, Looker asks if you have synced your data. Each data source requires the data be organized into a schema compatible with the Looker application or model. Looker can create a Looker-managed database where your data is automatically downloaded and organized into a schema compatible with the model or application, syncing your data for you:

    • Select Yes if you would like Looker to download, organize, and manage source data for the tool.

      If you select Yes, you are taken to the Connection Settings page to configure the Looker-managed database. Follow the instructions on the New Database documentation page to connect to your database or to create a new, Looker-managed connection, and provide credentials to your data source so that Looker can connect, download, and sync up your data. Once you are finished with this configuration process, you are returned to the tool installation process.
    • Select No if you would like to organize your data schema to match the tool’s requirements on your own.

    After you indicate whether you have synced your data, click Next.

  6. If you created a connection or synced your data through the Connection Settings page, the Marketplace asks if you are done creating your new connection. Click Yes.

  7. Each tool requires some configuration information that is specific for that tool, such as a connection name or visualization label. Looker displays a screen asking you for that tool’s configuration information:

    Select or enter the configuration information, and click Install. After the installation is complete, you can change this configuration information any time using the settings icon in the Marketplace Manage menu.

    Looker will complete the installation.

Once a tool is installed, you can open it through the Applications & Tools folder or through the Manage option in the Marketplace main menu. You will see any Explores built for the tool in Looker’s Explore menu, and you can view the tool’s LookML through the Develop menu.

If you installed a plug-in, the new visualization will be available on the visualization type menu in an Explore.

To use the installed visualization, make sure that you enable Looker cookies in your browser.

Installing a Tool from a Git URL

You can also install models and plug-ins directly from their Git repository:

  1. From the Marketplace main menu, choose Manage.

  2. Click the three-dot menu, and select Install via Git URL:

    Looker shows the Install via Git page:

  3. Enter the URL and commit SHA of the repository and version of the tool or visualization you want to install.

  4. Click Install.

Managing Installed Tools

From the Manage option in the Marketplace main menu, you can view a list of all installed tools. From the Manage page, you can also update tools, open them, change a tool’s configuration, or uninstall tools:

  1. Click Update to download any updates to the tool from Looker.
  2. Click Open to open the tool and view its lists of dashboards and Explores.
  3. Click the settings icon to modify a tool’s configuration.
  4. Click the trash can icon to uninstall a tool.