How to delete a project

To delete a project in TeleportHQ, go to your dashboard, open the ⋯ menu on the project's card and click Delete. Tick the box "I understand this will permanently delete" and click Delete project. TeleportHQ removes the project, takes its published site offline and frees its web address. A deleted project can't be restored.

Before you start#

• Deleting is permanent. There's no trash or undo, and you can't restore a deleted project from its backups. If you might need the project later, clone it first or, on a paid plan, download its code. See How to duplicate a project.
• Who can delete: the workspace Owner and Admins, from any project card. A Designer can delete projects in folders they were added to, or any project while the workspace has no folders. Editors and Viewers don't get Delete. Owners and admins can also delete with Select: see How to move or delete several projects at once.
• Expired workspaces: you can't delete projects while the workspace's trial or subscription has ended.
• Archived projects can't be deleted from the dashboard. After a trial that ended without a subscription, TeleportHQ deletes them automatically about 30 days after archiving. A workspace whose paid subscription ended keeps them until they're restored. See What does "Archived" mean on my project?.

Steps#

1. On your TeleportHQ dashboard, find the project you want to delete.
2. Hover the card and click its ⋯ menu.
3. Click Delete. The Delete project window opens, for example: "This will permanently delete “Sunny Bakery”. This action cannot be undone."

4. Tick the box I understand this will permanently delete “Sunny Bakery”, with your project's name.
5. Click Delete project.

If the project is a web app with a paid Web App slot#

The Delete project window also says "This is a web app covered by a paid slot."

1. Choose what happens to the slot:
   • To stop paying for it, tick Also cancel this paid slot at the end of the billing period — you keep it until then and won’t be charged again.
   • To keep the slot for another web app, leave the box unticked.
2. Tick the confirmation box and click Delete project.
3. If you kept the slot, TeleportHQ offers to assign it to another project that needs one.

Check that it worked#

A message confirms that the project was deleted, and its card disappears from the dashboard. If the project was published, its TeleportHQ web address and custom domain stop working.

Troubleshooting#

There's no Delete option in the menu Your role can't delete this project, or the project is archived. Editors and Viewers never get Delete, and a Designer only gets it in folders they were added to, or while the workspace has no folders. Ask the workspace owner or an admin to delete it.

"Could not remove project. Please try again." The project couldn't be deleted. If the workspace's trial or subscription has ended, deleting is blocked until the owner subscribes. Otherwise, wait a moment and try again.

Good to know#

• What deleting removes: the project's pages and files, its published site and deployments, its database, its visitor statistics, and people who were invited only to this project.
• To take only the site offline and keep the project, use Unpublish in the editor's Publish window instead. See How to take your site offline (Unpublish).
• Add-ons may keep billing. Custom domain and language slots, and Web App slots you didn't cancel, stay on your subscription after the project is deleted. Cancel them in the workspace settings if you don't need them. See How to buy, assign or cancel a web app slot.
• Deleting frees a project place in the workspace. See How many projects can I have?.
• To delete many projects at once, use Select on the dashboard. See How to move or delete several projects at once.
• Deleting a folder can also delete the projects inside it, if you tick that option. See How to organize projects in folders.