Manage organizations and projects

  • Updated

This article will help you:

  • Organize, update, and delete your Amplitude organization and projects

Once you've created your first organization and your first project, you will from time to time need to manage and update them. This article explains how to perform common tasks related to organization and project management in Amplitude.

NOTE: You may want to take this course on administering Amplitude in our Academy.

Feature availability

This feature is available to users on all Amplitude plans.

Approve and provision new users in your organization

New users joining an existing open organization or who are accepting an invitation to join will receive immediate access. For organizations requiring admin approval, however, new users will be unable to access the organization until approval is granted. 

Admins will receive email notifications whenever a new user joins. If access requires admin approval, you can approve join requests by opening the email and clicking Review access request. Otherwise, you can assign permissions to the new user by clicking on the button in the email (either Assign Project Permissions or Go to Settings, depending on whether you use project-level permissions).

View and edit your project information

Navigate to gear icon for settings.png> Organization Settings > Projects and click the name of the project you’d like to view or edit. This will open the General tab, where you’ll find the following information about your project:

Term Definition
Project ID

This is the project’s unique Amplitude-generated ID.

API Key This is the project’s API key, used for calling Amplitude’s APIs. Only admins and managers can view the API key.
Secret Key This is the project's secret key, which is also used for calling Amplitude’s APIs. Only admins and managers can view the secret key.
Session Definition This identifies the value Amplitude is currently using for this project to group events for sessions-based charts. The default setting is Session ID, but you can choose to group sessions by an event or user property instead.
Query Time Sampling This enables you to speed up your queries by restricting your analyses to a 10% sample of your users. It is disabled by default and is not available with Scale sampling.
Time Zone This is the time zone displayed on charts for this project. You can edit this value by selecting a new time zone from the drop-down menu; Amplitude will shift the timestamps of this project’s events to match. The default time zone is UTC (Universal Time Coordinated). This setting will affect all Amplitude users and queries, which includes the Dashboard Rest API. It will not affect the HTTP API or your raw data, as event ingestion will continue to be in UTC. 
Weeks Start On Specifies the day each week begins. 
Quarter Starts In Specifies the month in which the current quarter begins.
Currency Display The unit of currency displayed for revenue metrics.
User Downloads This is where you can enable or disable the download users feature in the Microscope, in the export cohorts feature, and the export breakdown tables.
Event Types Shows your project's current distinct count of event types sent to Amplitude.
Event Properties Shows your project's current distinct count of event properties sent to Amplitude.
User Properties Shows your project's current distinct count of user properties being sent to Amplitude.
Events This Month Shows the number of events your project has sent to Amplitude this month.
Events Last Month Shows the number of events your project sent to Amplitude last month. 

NOTE: Only admins and managers can edit project settings. All project information except the API key and secret key can be viewed by viewers and members.

If you've purchased the Scale add-on, you will also see counts for raw events this month and raw events last month.

You can add, remove, and edit annotations easily from the Annotations tab.

If you’ve purchased the Insights add-on, you can bulk manage your automatic and custom monitors from the Insights tab.

Delete a project

To delete a project, follow these steps:

  1. Navigate to gear_icon_for_settings.png > Projects.
  2. From the list, select the project you want to delete.
  3. Click Delete.

Change your name or URL, or delete your organization

If you are a Growth or Enterprise customer, reach out to your CSM to help you change your organization's name or URL, or to help delete your organization. 

If you are unsure who your CSM is or do not have one, follow the steps below to request a change:

  1. Use the URL/Name Change request form to request a URL or name change.
    • You must be an Admin of your organization in order to submit this request. If there are no Admins with your organization write that in the Why are you making this change? section of the form. 
  2. Use the Organization Deletion request form to request to delete an org.
    • If there are no Admins with your organization write that in the Why are you deleting your Amplitude organization? section of the form. 
  3. For each request, you must use the email address that exists on the Team Members page.
  4. Click Submit once you complete the form. You will receive a copy of the submitted request by email. 
  5. When the request has been processed, you will receive a confirmation email that the change or deletion has been made. 

NOTE: The Amplitude Support team responds to such requests the first Monday of each month, or the following Tuesday if Monday is an observed holiday. All requests sent before 9 a.m. Pacific Time on the first Monday of each month will be included in the batch. 

How to rotate your project's API key or secret key

Amplitude does not support rotating API keys due to the inherent public nature of API keys. Changing this key can affect ingestion and data loss if misused. However, with Admin approval we are able to re-generate your project's secret key on the backend. If you would like to submit a request to change the secret key, submit a support request here with the following information: 

  • The project ID and project name that you want to rotate the secret key for.
  • Three time options within the proceeding three days depicting an optimal time for Amplitude to make the change. An agent will reach out and coordinate the exact time with you.
  • Approval from an Admin of the project. If you are not an Admin, you must copy an Admin in the request.