Projects, organizations, and billing
Create, manage, and delete organizations, and delete, archive, or leave a project.
All projects on Sanity.io can be tied to an organization. An organization holds contact and billing information, and can have administrators, billing managers, and developers added to them. Agencies and freelancers can initiate projects and create organizations for their clients for a smooth hand-over.
These roles determine what each member can do with billing. Only organization administrators and billing managers can add or update a payment method; project roles, including project administrator, do not grant billing access. For details, see Plans and payments.
Gotcha
Looking to add a project to an organization? Projects are always assigned to an individual upon creation and can then be moved to an organization via the Manage interface. To move a project between organizations you must have admin privileges in the organization that currently owns the project.
Create an organization
- Log into manage.sanity.io
- Select a project and go to Settings
- Under General you'll find the “Organization” heading
- Here you can either select an organization you're already a member of, or create a new one from the link
- Fill in the Payment details and hit Save
Manage an organization
- Log into manage.sanity.io
- Projects will be listed out and sectioned by the organizations you're member of
- In the organization headings, push the “edit organization” link to go to its settings
- In the organization settings you get an overview over existing projects, as well as the team, billing information, and GDPR information.
Add contact details for an EU representative and Data Protection Officer (DPO)
- Follow the steps for managing your organization
- Under Settings you'll find buttons for adding contact details for your EU representative and Data Protection Officer
Delete an organization
- Move or delete all projects connected to the organization in the projects’ settings
- Follow the steps for managing your organization
- Under Settings, click the Delete Organization button
Delete a project
To delete a project:
- In Manage, select the project and go to Settings.
- Under Danger zone, click Delete project.
- Confirm the deletion.
Deleting a project ends its subscription. The already paid plan cost is prorated and refunded for the remainder of the month, and any usage-based charges accrued before the deletion are still invoiced.
Projects billed through Vercel Marketplace
Projects billed through Vercel Marketplace can't be deleted in Manage. Uninstall the resource from your Vercel dashboard to delete the project.
Archive a project
Archiving a project removes access to it but does not delete it permanently. The project can be reactivated at any time. Here is what happens to billing when you archive a project:
- Subscription stops — No further charges for your plan, seats, or add-ons.
- API and CDN access is blocked — No new usage can accrue against your project.
- Final invoice for outstanding usage — Any usage-based charges (API calls, bandwidth, etc.) incurred before archiving will still be invoiced.
- Reactivation available anytime — You can reactivate your project whenever you are ready. When you reactivate, a new invoice will be issued for your plan.
Example: If you are on the Growth plan and archive your project mid-cycle, you will not be charged for the subscription going forward. However, if you had outstanding API overages before archiving, you will receive a final invoice for that amount.
Leave a project or organization
Leaving removes you from a project or an organization and ends your access immediately. Every role can leave, including Viewer.
To leave a project:
- In Manage, select the project and go to Settings.
- Under Danger zone, click Leave project.
- Confirm that you want to leave.
To leave an organization:
- In Manage, select the organization and go to Settings.
- Under Danger zone, click Leave organization.
- Confirm that you want to leave.
Leaving doesn't delete anything. The project or organization keeps running and its content stays in place. If nothing should outlive your membership, delete it instead.
You can't leave as the only administrator
Sanity blocks you from leaving a project or an organization where you hold the only Administrator role. Promote another member to Administrator first, or delete the project or organization. This is the same check that blocks account deletion — see Delete your account.