Accessing and editing project information

The LookML Projects page provides list of all the LookML projects on the Looker instance and shows all the models in each project.

To access the LookML projects page, perform the following steps:

  1. Open the Develop panel by selecting the Develop option in the navigation panel.
  2. In the Develop panel, select Projects.

Viewing existing projects and their models

To view a list of existing projects, navigate to the LookML projects page.

In Production Mode, the LookML projects page lists projects that have been generated and pushed to production. In Development Mode, the page lists projects that you have pulled from production or that you have generated yourself in Development Mode. The LookML Projects page includes the following basic categories:

For information on specifying a new project or a new model for an existing project, see the Creating a new LookML project documentation page.

Viewing the listing for a project

The LookML Projects page displays the following elements for each project:

  • Project column: The name of the project. Each project may have one or more models listed next to it. Select the project name to navigate to the LookML for that project.
  • Models column: The set of LookML model files for the given project. If your Development Mode environment differs from production, this list can change between Development Mode and Production Mode. For example, you might have created a new model in Development Mode that you have not yet pushed to production.
  • Configuration issues column: If there is a problem with a model, the model shows a status that indicates the problem with the configuration.
  • Configure button: If the Configure button is available next to the project's listing, you can add or edit the project's model configuration.

If there is a problem with a model, the model shows a status that indicates the problem with the configuration.

Issue Explanation
LookML model file doesn't exist yet You see this issue if someone configured a model on this page but has not yet created a corresponding LookML file for it.
Configuration required for use You see this issue if someone created a new LookML model file in an existing project, but has not configured it on this page yet.
Connection 'x' does not exist The connection declared in the model file does not exist (such as if someone misspelled it or has not created it yet).
Model 'x' is not allowed to use connection 'y' The connection declared in the model file is not permitted according to the configuration on this page.
A model named 'x' is already configured in project 'y' Model names must be unique within your Looker instance, even if they are in different projects.

Viewing the listing for a Marketplace project

The Marketplace Projects section of the LookML Projects page lists projects that were created during the installation of a Marketplace application, block, or plug-in. The listing for each Marketplace project includes the following elements:

  • Listing: A link to the listing for the application, block, or plug-in in the Looker Marketplace.
  • Project: The name of the project. You can click on the name of the project to view or edit its LookML.
  • View LookML or Edit LookML button: You can navigate to a Marketplace project by selecting the View LookML button for a Marketplace block's read-only core project, or the Edit LookML for its config project, the latter of which can be customized. For more information on customizing Marketplace blocks, see the Customizing Looker Marketplace Blocks documentation page.
  • Models: The set of LookML model files for the given project.
  • Configure button: If the Configure button is available next to the project's listing, then you can add or edit the project's model configuration.

Viewing the listing for a pending project

The Pending Projects section contains models that are configured with a project name but that have not yet been generated. Thus, the Pending Projects section contains projects and models that are only configured and that do not yet have any LookML.

Configuring models before the project exists is useful if you have developers who have not been given either the manage_models or the manage_project_models permission. Because the model has already been configured, those developers can run queries as soon as they create the project and that model. When the project is generated, then the listing for that project moves to the top section of the LookML Projects page.

The Pending Projects section includes the following elements:

  • Project column: This section lists projects that are configured but not yet generated. The project name in this field is the intended name of the project. Select the project name to display the New Project page where you can generate that project. You must be in Development Mode to reach the New Project page.
  • Models column: The model name that was specified when creating the model configuration.
  • Allowed connections column: The column to the right of the model name shows the connections that were allowed for this model when the model configuration was created.
  • Configure button: The Configuration button lets you change the project name and the connections that are permitted for this model.
  • Add LookML button: The Add LookML button opens the New Project page for that project, letting you use the LookML generator to automatically generate LookML that is based on a set of tables in your database.

Adding and editing configurations

If the Configure button is available next to the project's listing, you can add or edit the project's model configuration.

If the model does not have a configuration, when you select Configure, Looker displays the Configure a Model window. In the Configure a Model window, you can specify the model name, the project name, and which connections are available to the model.

The list of connections includes only connections that have a Connection Scope that includes the model's project. If the Connection Scope is set to All projects, Looker displays (Instance wide) next to that connection.

If the model has a configuration, when you select Configure, Looker displays the Edit Model Configuration window. In the Edit Model Configuration window, you can change which connections are available to the model.

When you edit the configuration for a model, you can view the model name but not rename it. Models are named according to the filenames that you use when you edit the model files in the Looker IDE.

In the Project field, you can specify that the model should be associated with a different project. For example, if you created a new project including a model with the same name, you can transition the model configuration to be associated with the new project's model.

In the Allowed Connections field, you can limit the model to use a list of specific connections, or you can allow the model to use any connection (all current and future connections).

Renaming a project

If you are a Looker admin, you can change your project name using the project's Project Settings page. To see the Project Settings page, open your project and select the Settings icon from the left-hand icon menu.

To rename a project, perform the following steps:

  1. Verify that you have Development Mode turned on.
  2. Navigate to your project in the Looker IDE.
  3. In your project, select the settings icon in the IDE navigation bar to open the project settings panel.
  4. Select Configuration in the project settings panel.
  5. Use the Name field under Project Configuration to edit the name of your project.
  6. Scroll down in the Project Configuration page and click Save Project Configuration to save the new project name.

Deleting a project

If you are a Looker admin, you can delete an existing project with the project's Project Settings page. To see the Project Settings page, open your project and select the Settings icon from the left-hand icon menu.

A deleted project no longer appears in the Projects section of the LookML Projects page, but still appears in the Configured Projects section.

To remove the project configuration, which removes the project from your development environment completely:

  1. Navigate to your project in the Looker IDE.
  2. In your project, select the settings icon in the IDE navigation bar to open the Project Settings panel.
  3. In the project settings panel, choose Configuration to see the project configuration.
  4. Under Project Configuration, select Delete Project.
  5. In the Delete Project window, verify the warnings and the unsynced changes that are lost if the project is deleted.
  6. If you are sure the project should be deleted, type the project's name in the text box. To cancel the operation and navigate back to your project, use your browser's Back button.
  7. Click the Permanently Delete <project name> button.