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

When first onboarding, a default project is created for you. You can create additional projects as needed. You can change the default project by editing its settings as described below. There can only be exactly one default project.

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 the default project. Note that if you mark this project as the default, any other project that was previously marked as default will be unmarked.

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.