User Guide Getting Started Help Center Documentation Community Training
New LookML
Old LookML
New LookML
Types of Files in a Project

A project in Looker is a collection of related LookML files that tell Looker how to connect to your database, how to query your data, and how to control the user interface’s behavior. This page lists the types of files that can be present in a project, with a brief description and links to more information about each.

Where Do Projects and Files Come From?

When a new project is created, Looker’s project generator creates a baseline set of files:

For more information about project generation, see the LookML Terms and Concepts and Creating a New LookML Project documentation pages.

Model Files

A model file specifies a database connection and the set of Explores that should use that connection. This is where you’ll define which data tables should be used (as included views) and how they should be joined together, if necessary.

For more information on model files, see the Understanding Model and View Files and LookML Terms and Concepts documentation pages.

View Files

A view file specifies a table to query and the fields (dimensions and measures) to include from that table.

For more information on view files, see the Understanding Model and View Files and LookML Terms and Concepts documentation pages.

Dashboard Files

Looker supports both user-defined dashboards and dashboards that are built directly into your project using LookML. If your project contains LookML dashboards, they will be defined in dedicated dashboard files.

For more information on LookML dashboards, see the Creating LookML Dashboards documentation page.

Data Files

In Looker, you can use TopoJSON files to specify custom maps for your visualizations. If your project contains TopoJSON-based custom maps, they will be defined in dedicated files in your project’s data section.

For more information on using data files for custom mapping, see the Map Options and map_layer LookML parameter documentation pages.

Documentation Files

You can write documentation and other notes about your project using GitHub-flavored markdown in one or more documentation files.

For more information, see Documentation Files on the Understanding Other Project Files documentation page.

Manifest Files

Your project may contain a project manifest file that lists files from other projects to import into the current project, or may contain customized localization settings.

To have the option of adding a manifest file, the Looker admin must enable the Project Import experimental Labs feature.

Locale Strings Files

If you are localizing your project, it may contain files with translation strings corresponding to different languages.

For more information, see the Model Localization documentation page.

Other Files

Your project may also contain other files whose filetypes are not recognized by Looker’s IDE as belonging to one of the categories above.

For more information on filetypes that are likely to be stored in the Other category, and on moving files from the Other category, see the Understanding Other Project Files documentation page.

Accessing Project Files

To view existing projects on the LookML Projects page, click the Develop menu and choose Manage LookML Projects.

The projects you see in those lists depend on the following things:

For more information, see the Accessing and Editing Project Information documentation page.