The Admin Dashboard serves as the central hub for managing your workspace and user-related activities. From here, you can efficiently oversee and control various aspects of your platform.

  • Insights Dashboard: Gain valuable insights into platform usage.
  • Manage Users: Handle user-related actions, such as inviting, elevating admins, and deleting users.
  • Manage Workspaces: Create, edit, and delete workspaces while managing workspace-specific details and user memberships.


The Dashboard section provides an overview of essential metrics and statistics regarding users, workspace, and activity. This snapshot allows you to track the usage and performance of your platform.

Get insights into your organization’s usage of Hoppscotch.

  • Number of Users: Monitor the count of registered users.
  • Number of Workspaces: Keep track of the total number of workspaces.
  • Number of Requests: Measure the volume of requests made by your organization.
  • Number of Collections: Track the quantity of collections within the platform.

Manage users

In Hoppscotch enterprise edition, a user needs to be explicitly invited by the admin to create an account on the platform.

The Users section empowers you to effectively control user-related actions. It streamlines the process of user management, making it simple to oversee the user base.

  • User List: View a comprehensive list of all users and their activity on your platform
  • Invite Users: Send invitations to new users, welcoming them to the platform.
  • Admin Privileges: Elevate users to administrative roles for increased permissions.
  • User Deletion: Delete users when necessary.

Manage Workspaces

In the Manage Workspace section, you can efficiently handle workspace-related operations, ensuring that collaborations and projects run smoothly.

  • Workspace Creation: Establish new workspaces tailored to specific projects or departments.
  • Workspace Editing: Modify workspace details and configurations as needed.
  • Workspace Deletion: Disband workspaces that are no longer relevant.
  • User Memberships: View and manage the users associated with each workspace.

Server Settings

Access controls

  1. Site Protection: When site protection is activated, all visitors to your Hoppscotch instance will be prompted to create an account and log in to use Hoppscotch. Site protection is enabled by default on Hoppscotch Enterprise and can be disabled as needed.

  2. Domain Whitelisting: Domain Whitelisting enables organization admins to grant access to users with email addresses under the organization’s domain without explicit approval.

    To enable domain whitelisting, activate the “Enable Whitelisted Domains” option and simply add the domains used by your organization for email addresses.

Authentication Providers

  1. Configure Authentication Providers: Customize authentication providers, including Google, Microsoft, GitHub, and email, directly from the settings page.

  2. Configure SAML Settings: Configure your SAML settings for your SAML based Single sign on.

  3. Configure SMTP Settings: Configure your SMTP settings for seamless email integration.

  4. Configure OIDC Settings: Configure your OIDC Settings for Single Sign-On based authentication.

  5. Configure Audit Logs Settings: Configure your Clickhouse settings for audit logs and download audit logs

  6. Reset Configurations: If needed, reset your configurations back to their original state.

Custom Banner

Custom banners allow self-host admin to share important announcements such as a scheduled maintenance or instance upgrade with the rest of your team.

  • Create Announcements: Navigate to the Banners tab and toggle the “Show Banner” action. Select the type of banner (Information, Warning, or Danger), craft and preview the message content, and save it to activate announcement immediately.

  • Edit Announcements: You can modify the announcements directly by editing the message or changing the banner type and further saving the changes to implement them.

  • Delete Announcements: Manually end an announcement by toggling the “Show Banner” action OFF.

License Settings

The License Settings enable you to both configure and view your enterprise license information.

You have the following options:

  • Edit and Configure License Key: You can modify and configure your license key as needed.

  • View License Status: Obtain insights into the current status of your license. This includes details such as License Status, Issued to, Number of seats purchased, and expiry date.

Hard Reset Configurations

If you need to perform a hard reset of the server configurations, execute the following command in your terminal to reset all your environment variables:

docker exec -it <db_container_id> psql -d hoppscotch -c "TRUNCATE \"InfraConfig\";"

You can replace <db_container_id> with the actual ID of your Docker container.