Manage Projects

Projects allow you to organize Nautobot and other instances into logical groups. These could represent different teams, departments, or environments.

Find Your Projects

To find your projects, navigate to the project dropdown, which is the topmost element in the left-hand navigation under console and displays as the name of your currently selected project. Clicking the current project name will open a dropdown displaying all available projects. You can select a different project from this list to view and manage instances within that project.

Common Pitfall

If you do not see the instances you expect, ensure you have selected the correct project from the dropdown. Each project has its own set of instances, so switching projects will change the instances displayed.

Default Project

Your default project is the project selected automatically when you sign in to the Console. When you first onboard, one of your projects is set as your default; you can create additional projects and change which one is your default at any time.

The default project is a per-user preference — each user in your organization has their own. Changing your default only affects your own view; it does not change the default for anyone else. You have exactly one default project at a time. You can change it by editing a project and marking it as your default, or from the Set Default Project page.

Create a New Project

You can create a new project by clicking the + Add New Project button at the bottom of the dropdown.

Edit a Project

To edit a project, first hover over the project name in the dropdown and click the pencil icon that appears to the right of the project name.

A popup will appear with a form to edit the project's details.

Here you can set the display name for the project and optionally mark it as your default project. Marking this project as your default moves your default onto it, so the project that was previously your default is no longer your default. This only changes your own default — other users in your organization keep theirs.

Delete a Project

To delete a project, first edit the project as described above. In the edit popup, click the Delete Project button at the bottom.

Note: you cannot delete a project that contains active instances. To delete a project, you must first delete or move all instances out of the project.