Projects 🚧

Projects let you group your maps and datasets of any kind (together called documents) by what they belong to. You decide what goes together: one project per customer, per app, or per team. Projects are simple, single-level groups, so there are no folders inside folders to get lost in.

You can use one document in several projects and still maintain it in one place. Each project also has its own API keys, so you can keep unrelated work apart.

Some common ways to use projects:

• Freelance developers: one project per customer
• Cartographers and GIS experts: one project per map or data project
• Companies: one project per environment (production, testing) or per team (developers, designers, data people)

Catalog vs custom documents

A project can hold two kinds of documents:

• Catalog documents – ready-made maps and datasets from MapTiler. We maintain them, so they keep receiving our style and data fixes automatically. You can’t edit Catalog datasets. When you edit a Catalog map, you get your own copy that no longer receives our updates.
• Your own documents – maps you’ve customized and data you’ve uploaded or created. You have full control over them, and they only change when you edit them.

Each of your own documents has a home in at least one project. It can’t exist outside a project.

Create a project

1. In the side panel, select Projects.
2. Click New project and give it a name.

A new project starts empty. To fill it, click + Add in the project and choose:

• Select from Catalog – ready-made maps and datasets from Catalog
• Use own content – upload your own data
• Blank map or Blank dataset – start from scratch

You can also add, move, or copy documents from your other projects.

Add, move, and copy documents

To add, move, or copy a document, open its menu … and pick an option. Each option works a little differently for Catalog documents and your own documents:

Action	Catalog documents	Custom documents
Add to project	Adds the Catalog document to another project, where it keeps receiving our updates. Each Catalog document can be in a project only once.	Adds the same document to another project. When you edit it, it changes in all projects where you use it.
Move to project	Moves the document to another project. It keeps receiving our updates.	Moves the document to another project, so it’s no longer in the current one.
Copy to project	Maps: creates your own independent copy that no longer receives our style updates. Datasets: not possible.	Creates a new, independent copy in another project. Changes to the copy don’t affect the original, and the other way round.

A few rules apply:

• Maps take their datasets along. When you add a map to a project, its datasets are added too. When you move a map, its datasets move with it, unless other maps in the current project still use them. Those datasets stay and are also added to the new project.
• Datasets that maps use stay put. You can’t move a dataset away from a project where maps still use it. We offer to add it to the other project instead.
• Documents used in several projects can be moved only from inside a specific project, not from All documents.

To create a copy within the same project, use Duplicate instead of Copy to project.

Remove from project vs delete

• Remove from project takes a document out of one project but keeps it in the others. It’s available only for documents used in more than one project, and only from inside the project you want to remove it from.
• Delete removes the document from all your projects at once. You can’t delete datasets that maps still use, or documents marked as Live.
  • Your own documents are deleted from your account.
  • Catalog documents are only removed from your projects. You’ll still find them in Catalog and can add them again anytime.

Project credentials

Each project has its own API keys. To see them, open the project menu … and select Credentials. To manage all keys, go to Credentials in the sidebar.

Delete a project

When you delete a project:

• Documents used in other projects stay there.
• API keys assigned to the project stay available in Credentials.
• Documents that are only in this project are deleted. Before you confirm, we show which of them are marked as Live.