Quick guide for administrators

note

For the legacy version of this guide, refer to this document.

The Administrator role in the Katalon Platform gives you full control over managing users, licenses, and organizations within your account. This guide will walk you through the key responsibilities and tasks of an administrator, including:

• Inviting and managing users in your organization
• Assigning and editing licenses
• Managing organizational structure
• Adjusting user roles and permissions

Requirements

• You have created a Katalon account. Register for a Katalon account if you don't have one.
• You must be assigned the Account Admin role to perform this action. Learn more about roles and how to assign Account Admins.

Invite users to join an Organization

As an administrator, you can invite new users to join your organization and immediately assign them licenses.

1. Go to Admin Settings. (You can find Admin Settings at the upper right corner of the page).

2. Click Org > User Management tab. The user directory appears with all users in a list.

3. Click + Add user. The Add Users dialog box appears.

   

4. Input the email addresses of the Users you would like to invite.

   • Separate entries by pressing space or enter.
   • You can copy-paste email entries.

Assign licenses during user invitation

5. Select the licenses you want to assign by checking the boxes.

   The license source in the dropdown indicates where the licenses are available within the Account.
   

6. (Optional) Select the Organization you would like these Users to belong to.
7. (Optional) Select the Project you would like these Users to work on.
8. Click Add to proceed.

Assign licenses after invitation

If the user is already existing in your account:

1. Go to Admin Settings. (You can find Admin Settings at the upper right corner of the page).
2. Click Org > User Management tab. The user directory appears with all users in a list.
   
3. Locate the user you want to assign a license to and open their detail page.
4. Click Change next to the license type.
5. Select a license source from the available pools in your Account.

License Management

Administrators control how licenses are distributed and used within the account.

What is a Dedicated License?

A dedicated license is a fixed number of licenses allocated to a specific Organization, limiting how many licenses that Organization/sub-Organization can use and manage.

When you purchase Katalon licenses, they are added to your Account-level license pool by default. This pool is shared across all users in the account, making licenses accessible to everyone. To improve license governance, you can assign dedicated licenses to Organizations and sub-Organizations.

Once Organizations are set up, you can:

1. Assign dedicated licenses to each Organization or sub-Organization.
2. Define limits on how many licenses each group can access and manage.

---

Examples

The following examples illustrate how dedicated licensing functions across Accounts, Organizations, and Sub-Organizations:

First example: This account has 200 TestOps licenses. They assign 20, 10, 1, and 5 licenses to four Organizations, respectively. These numbers represent the dedicated licenses each Organization can use and they cannot exceed that amount.

• Dedicated: The total number of licenses explicitly assigned to an Account, Organization, or Sub-Organization.
• Pool: The number of licenses still available after allocation to sub-levels (e.g., from Account to Organization, or Organization to Sub-Organization).
• Assigned User: The number of users who have actively claimed a license in that specific level.
• Available: The number of unclaimed licenses remaining at that level, ready to be assigned to users.

---

Second example: This Organization receives 10 dedicated licenses. It then assigns 5 licenses to a sub-Organization, reducing its remaining pool to 5 licenses.

If they later create a second sub-Organization, they can assign it up to 5 licenses, depending on what's left in the parent Organization’s pool.

---

Assign Dedicated Licenses

To assign licenses to an Organization that has not received any dedicated licenses yet:

1. Click Assign Dedicated Licenses.

2. Select an Organization from the dropdown, enter the amount, and click Assign.

Edit Dedicated Licenses

This section shows you how to edit number of dedicated licenses given to organization.

1. Go to Admin Settings. You can find Admin Settings at the upper right corner of the page.
2. Click Account > License Management.
3. Hover over the Edit icon (pen icon) of the organization you want to edit the dedicated license for.

4. You can increase or decrease the initial license amount: For example, if your account has 200 TestOps licenses and you've assigned 5 to an Organization (with 4 already in use):
   • Increasing adds more licenses to the Organization from the Account-level pool (e.g., from the remaining 195).
   • Decreasing reduces the Organization’s allocation:
     • You cannot reduce below the number currently in use.
     • Setting the value to 0 revokes all dedicated licenses from the Organization, including those in use.
5. Click Save to proceed.

Revoke Dedicated Licenses

If needed, you can revoke all dedicated licenses from an Organization:

notes

Any claimed or in-use licenses will now be taken from the Account license pool, if available.

1. Go to Admin Settings. You can find Admin Settings at the upper right corner of the page

2. Click Account > License Management.

3. Hover over the Revoke icon (left-arrow icon) of the organization you want to revoke all dedicated licenses from.

   
   
   

4. A confirmation box will appear. Click Revoke to continue.

User Management

View the User Detail Page

1. Go to Admin Settings > Organization. You can find Admin Settings in the upper-right corner of the page, indicated by a cog icon.
2. Click Org > User Management.
3. In the user directory, click on the name of the user whose details you want to view.

The User Detail page displays the following information:

• Full name
• Profile picture
• Contact details
• Employment start date
• Account-level role – Determines if the user is an account-level admin
• Affiliated Organization – The organization the user belongs to
• Licenses possessed – Includes sources like:
  • TestOps - License Source
  • KSE License Source
  • TestOps Guest - License Source
• Joined Projects List – Projects the user is a member of

Change a User's Account Roles

To change a user's Account roles:

1. Go to Admin Settings > Organization. You can find Admin Settings in the upper-right corner of the page, indicated by a cog icon.
2. Click Org > User Management.
3. In the user directory, click on the name of the user whose details you want to view.

4. Click on the Change Role & Permission under the label Account Role

5. The Change Role and Permission dialog box appears. Click on the dropdown menu at the upper left corner and assign roles as needed.

6. Click Update.

Change a User's Project Roles

To change a user's Project roles:

1. Go to Admin Settings > Organization. You can find Admin Settings in the upper-right corner of the page, indicated by a cog icon.
2. Click Org > User Management.
3. In the user directory, click on the name of the user whose details you want to view.

4. Click on the Change Role and Permission button that corresponds to the same row of the Project you'd like to change the User's permissions in.

   

5. The Change Role and Permission dialog box is displayed. In the dropdown labeled Project Role, select the Roles you'd like to add for the User.

   

6. Click Update.

Change a User's Organization

To change a user's Organization:

1. Click on the Change button under the label Organization.

   

2. The Change Organization dialog box appears. Select the new Organization from the dropdown menu.

   

3. Click Save.

Resend invitation to a user

If the invitation link expires and the user hasn't accepted it, you can resend the invitation.

1. Locate the user with the Pending status.

2. Hover at far right end of that user's row. Click Resend invitation or Copy invitation link.

   

Deactivate a user

This document shows you how to remove/deactivate a user from your Account.

1. Navigate to your chosen user's User Detail page.

2. Click the three-dot menu button at the upper right corner of the information box, then select Deactivate User.

   

3. The Deactivate User From Account dialog box appears. Continue by clicking Deactivate.

   

4. Their Status is now Inactive.