By the end of this you will know how to create a project, rename it, and delete it safely. The important part is the last one: deleting a project does not delete what is inside it, and knowing that in advance saves a lot of worry.
In this article:
Creating a project
There are two places to do this.
From the dashboard:
Open the project dropdown above the table. It reads
All projectswith how many you have, for exampleAll projects (4), or the name of the project you are viewing.Select
New project. Atlas creates the project straight away, namedUntitled project(thenUntitled project 2, and so on), and opens its settings in a window titledNew project.Type a name into
Name. The placeholder name is selected, so typing replaces it.Add research, saved personas or a colour palette now if you have them, or leave them for later. See What project settings control.
Select
Save.
The new project is then picked in the dropdown, so the table shows its contents and new builds open in it.
⚠️ Closing the New project window without selecting Save deletes the project again, along with any research or personas you added to it. To keep the project, select Save, even if you have not changed anything.
While starting a build: every build flow asks for a project first. Select + Create a new project, type a name into Enter project name..., and select Create. The build then continues into the project you just made.
Name it after the brand rather than the campaign. Projects hold your voice and research, which outlive any one campaign.
If creating fails
What you see | What it means |
| Project names must be unique. Pick another. |
| You are at the limit. Delete or reuse an existing project. |
| A temporary failure. Try once more. |
| The same failure, worded differently inside a build wizard |
Renaming a project
Open the project dropdown above the table.
Select the gear next to the project. Its tooltip reads
Project settings.Change
Name.Select
Save.
Renaming is cosmetic. It changes nothing about the pages, bundles or cart drawers inside, and nothing on your storefront. Project names must be unique: if another project already has the name, the Name field shows A project with this name already exists. If saving fails you will see Couldn't save settings. Try again.
The limits
Limit | Value | What happens at the limit |
Projects per store | 25 |
|
Items per project | 25 | Moving one item shows |
An item is any page, store, landing page, bundle or cart drawer assigned to that project. Neither limit varies by plan.
When assigning several items at once to a project with limited room, Atlas tells you how much room is left rather than partially filling it, for example 20/25 used — not enough room for 8 when you have selected 8 items.
💡 If you are near 25 items, pick the project in the dropdown and use Filter to show only Draft rows, then delete old drafts you no longer need. Deleting a draft frees a slot and has no effect on your store or your bill.
Deleting a project
Open the project dropdown above the table.
Select the gear next to the project to open
Project settings.Select
Delete projectat the bottom of the window.Project settings closes and a confirmation titled
Delete projectopens. Read it, then selectDelete project.
Selecting Cancel in the confirmation brings Project settings back. If you were viewing the project you deleted, the table switches to your most recently created remaining project, or to All projects if none are left.
A project you have only just created with New project has no Delete project button. Closing its window without saving deletes it instead.
What deleting removes and what it keeps
Read this carefully: it is far less destructive than it sounds.
Kept:
Every page, store, landing page, bundle and cart drawer in the project. They stay in your Atlas account and become unassigned, with no project.
Everything already published to your theme. Your storefront does not change at all.
Your active bundles and cart drawer. They keep running.
Removed:
The project itself, and its settings: the research documents, the
How should we use these documents?choice, the saved personas and the colour palette.
Deleting the project itself cannot be undone, and the confirmation names the project, here Skincare launch:
Are you sure you want to delete Skincare launch? This action can't be undone.
Pages, bundles, cart drawers, images, and listicles in this project will remain in your store and become unassigned (no project). Activity log entries for this project will be removed.
⚠️ The project's research documents and saved personas are deleted with it and cannot be recovered. Atlas has no download for research files, so keep your own copies, and recreate any persona you want to keep in another project with Add persona before you delete.
Next steps
Assigning pages, bundles and cart drawers to a project, to tidy up anything left unassigned