Accessing LookML project files

The Looker IDE displays project files in the file browser side panel of the Looker IDE. LookML developers can customize the file organization to match your project, as described on the Working with the IDE file browser documentation page.

You can access project files in the following ways:

Accessing project files from the Develop panel

You can access project files from the Develop section of the navigation panel. The projects you see in the Develop panel depend on the following settings:

  • Your permissions: To see a project, you must have the develop permission for at least one model in the project.
  • Your current mode: You may see additional entries in the Develop panel when you are in Development Mode versus Production Mode. For example, if you created a new project in Development Mode that you have not yet pushed to production, then that project would be visible in the menu only when you are in Development Mode.

To access project files from the Develop panel:

  1. Select Develop in the navigation panel to open the Develop panel.
  2. In the Develop panel, select the name of the project that you want to access.
  3. When you open a LookML project from the Develop panel, the Looker IDE opens the project to one of the LookML files in that project:
    • If the project contains a document file named readme.md, the IDE will open that file.
    • If there's no readme.md document file, the IDE will open the first alphabetical document file.
    • If there are no document files in the project, the IDE will open the first alphabetical model file.
    • If there are no model files in the project, the IDE will open the first alphabetical file of any type.
  4. To open a different project file, select the filename in the side panel of the Looker IDE. See the Working with the IDE file browser documentation page for more information about the organization of the Looker IDE.

Searching for and jumping to LookML objects or project files

In the Looker IDE, you can do a quick search to navigate directly to LookML objects and project files. Use the keyboard shortcut Command-J (Mac) or Ctrl+J (Windows), or select the Jump to object or file icon from the file browser or the object browser.

A text field opens where you can enter a search term, which can be a word or any part of a word. As you type, the search results show all matching objects and files.

The results show all files and objects whose names include your search term:

  • For LookML objects, the search results show the project file where the object is defined.
  • For project files, the search results show the IDE folder where the file is located.

Select a file from the search results to open the file, or select an object to navigate to the object's definition.

Accessing LookML from an Explore

You can also directly access the LookML for an Explore or for a field from an Explore.

  1. To access the LookML for an Explore, select the Looker icon near the Explore name.
  2. To access the LookML for a field in the field picker, open the field's gear menu in the field picker and select Go to LookML.
  3. To access the LookML for a field in the results table, open the field's gear menu in the table header and select Go to LookML.

After you select a field, you are taken directly to the field definition in the corresponding LookML file.

Accessing LookML from the object browser panel

You can use the object browser panel to view all the objects in your project or to navigate to the LookML for a specific object. To use the object browser panel:

  1. Select the object browser icon below the folder icon in the Looker IDE.
  2. Navigate to the LookML for an object by selecting the name of the object in the object browser panel.

When you select an object, the IDE displays the file in which the object is defined and positions your cursor on the first line of the object's declaration.

For more information, see the Navigating projects with the object browser panel documentation page.