Skip to main content

Create and manage projects

Create, delete, duplicate, tag, and otherwise manage your Hex projects.

  • The Community plan is limited to 3 projects.
  • Users will need the Editor or Admin role to create and manage projects.

Projects home

Your default landing page in Hex is the workspace Home. You can quickly find projects you recently viewed or starred.

Each section of the Projects page can be filtered by the category and status of projects, which are defined by workspace Admins.

You can also see a variety of metadata about each project, including your level of access, the project creator, the time of last edit, publication status, and total number of project views. In the All Projects list, projects can be sorted by either the date of most recent access or by its total number of views over all time, or in the last 7, 14, or 21 days.

Your Hex workspace provides a robust search engine that allows you to locate projects down to individual lines of code written within them. Select the workspace search bar or use the keyboard shortcut / to begin your search. Narrow your results down by using the filters at the top of the search modal.

Creating a new project

You can create projects in Hex from scratch or import them from .ipynb or .yaml files.

Create a project from scratch

Select the New project button on the Projects page to generate an empty project.

From here, you may name the project and add a description, status, and any categories. By default, projects will be created using a Medium compute profile, which offers 8 GB of memory and 2 CPUs. The compute profile can be changed from the project creation modal or via the Compute profile section of the Environment sidebar.

Upload an existing notebook


While we support upload of any .ipynb file, you may run into package-related issues while migrating your work from environment to environment. See the Package Management section for more details on configuring your environment in Hex.

You can upload any existing .ipynb (Jupyter Notebook) file into Hex. Since this file format typically stores the outputs from the last time it was executed, the outputs will often appear instantly in the project without needing to be re-run.

If you have an existing Hex project .yaml file, you can upload that using the Import button on the Projects home page as well.

Managing projects

Project options

Once you are inside the project, the project name dropdown offers several options for a project:

Rename the project

Users with Full Access project permission can rename the project.

Duplicate the project

Users with Editor or Admin roles that have Can View or higher project access can duplicate the project. The new, duplicated project does not inherit any project sharing permissions from the original.

Export as .yaml or .ipynb

There are two options for file export: .yaml or .ipynb. Projects can be exported by users with Can View project permission or higher. Learn more on how to use the file format options here.

Delete the project

To delete a project, select Move to trash from either the project dropdown menu or the homepage project listing. Projects will remain in the trash for 7 days, at which point they will be permanently deleted. Any permanently deleted projects will be fully removed, along with all historical versions and published apps. Deletion is only executable by users with Full Access.

Clear outputs

This option is only available from the projects page. Clicking "Clear outputs" will clear the outputs from all cells in your project. This option is intended to be used in situations where a cell generates a very large output that crashes or overwhelms your browser. After clearing the project's outputs, it's recommended to avoid rerun the project in order to avoid regenerating the large output. Instead, identify the cell that generated the large output, and either delete or modify it before rerunning the project.