Skip to main content

Create and manage projects

When you create your Imply Polaris organization, Polaris creates your first project with the same name as your organization.

A project represents a base entity that holds tables, data sources, files, jobs, visualizations, alerts, and reports. Users can have different permissions for each project. For example, a data writer in one project can be a data reader in another project.

You may want to use multiple projects to:

  • Separate environments like development, staging, and production.
  • Organize your account for different departments or customers.
  • Add projects to different regions and of different sizes.

Each organization can have up to 25 projects per region.

You can view billing information for your whole organization or per project.

If you are on a paid plan, you can create and manage projects in the Polaris UI or by using the Projects API. This topic focuses on the Polaris UI. For information on how to create projects using the Projects API, see Create and manage projects by API.

Prerequisites​

Users with the AdministerProjects permission and members of the Organization Admin group can create and manage projects. For information on permissions, see Permissions reference.

You must be on a paid plan to create multiple projects per region. To learn how to upgrade to a paid plan from a free trial, see Upgrade to a paid plan.

Create a project​

Follow these steps to create a new project:

  1. Click the user profile icon located in the top-right corner and select Administration.
  2. On the Projects page, click New project.
  3. In the New project dialog, enter the name of the project. Project names must contain at least one character and can't exceed 128 characters.
  4. Select a region where your project will be deployed. Once selected, the region can't be changed.
  5. In the Choose project size dialog, select the size for your project.
  6. Click Create project.
  7. Once the project is created, it enters the Running state.

View project ID​

To view your project ID, expand the project selector drop-down located at the top of the left sidebar and click the ellipsis icon next to the project's name.

The following screenshot shows the project selector menu:

Project selector menu

You can access the same menu from the Projects page by clicking the ellipsis icon next to the project name.

Switch between projects​

When you log in to your organization, Polaris displays the project you accessed last. You can switch between projects by using the project selector.
If you have multiple organizations, you must log in to each organization separately.

The following screenshot shows the project selector for an organization with two projects:

Project selector

Rename a project​

Follow these steps to rename a project:

  1. Expand the project selector drop-down in the left sidebar.
  2. Click the ellipsis icon next to the project name.
  3. Click Rename.

You can access the same menu from the Projects page by clicking the ellipsis icon next to the project name.

Delete a project​

Deleting a project is irreversible. When you delete a project, you also delete all of the project's assets, including tables, files, jobs, and connections.

Each organization must have at least one project. You can't delete the last project in the organization. You can delete the last project in a region as long as you have another project in a different region within the same organization.

Follow these steps to delete a project:

  1. Expand the project selector drop-down in the left sidebar.
  2. Click the ellipsis icon next to the project name.
  3. Click Delete.
  4. Confirm your selection. Polaris can take a few minutes to delete a project.

You can access the same menu from the Projects page by clicking the ellipsis icon next to the project name.

Learn more​

See the following topics for more information: