Chrome Extension

Overview

The TestKase Chrome Extension adds a side panel to GitLab issue pages, giving you full test management capabilities without leaving your browser. When you navigate to any issue on gitlab.com, the extension detects the page, identifies the project, and displays linked test cases, test cycles, and available actions in a convenient side panel. Every action you perform syncs back to TestKase in real time.

Prerequisites

Before using the Chrome Extension with GitLab, make sure you have:

• Google Chrome browser (latest version recommended).
• An active TestKase account with at least one project.
• A Personal Access Token (PAT) generated from TestKase under Settings -> API Keys. See API Keys for details.
• A GitLab account with access to the project you want to connect.

Installation

1. Visit the Chrome Web Store and search for "TestKase".
2. Click the TestKase extension listing.
3. Click Add to Chrome and confirm the permissions prompt.
4. Once installed, click the Extensions icon (puzzle piece) in the Chrome toolbar.
5. Click the pin icon next to TestKase to keep it visible in your toolbar for easy access.

Setup

After installation, you need to authenticate and map your project:

1. Log in with your PAT -- Open the extension (click the TestKase icon in the toolbar) and enter your Personal Access Token. The extension validates the token and connects to your TestKase account.
2. Map a TestKase project to your GitLab project -- Select the TestKase project you want to link to the GitLab project you are working in. This mapping tells the extension which TestKase project to use when you navigate to issues in that GitLab project.

Once the mapping is saved, the extension is ready to use. Navigate to any issue in the mapped GitLab project and the side panel will activate automatically.

How It Works

1. Navigate to a GitLab issue -- Open any issue page on gitlab.com (e.g., https://gitlab.com/your-group/your-project/-/issues/45).
2. Extension detects the platform -- The extension recognizes that you are on a GitLab issue page and checks whether a project mapping exists for that project.
3. Side panel activates -- If a mapping is configured, the side panel opens and displays the test cases and test cycles linked to that issue, along with available actions.
4. Perform actions -- Create test cases, link existing ones, generate tests with AI, manage cycles, and execute tests -- all from the side panel.
5. Automatic sync -- Every action syncs back to TestKase in real time. Test cases created from the extension appear in your TestKase project immediately.

Key Features

Create Test Cases from GitLab Issues

Create new test cases directly from any GitLab issue. The extension pre-populates context from the issue (title, description) so you can quickly define test steps and expected results without switching tabs.

Link and Unlink Test Cases

Link existing test cases from your TestKase project to the current GitLab issue. You can search by name or ID, link multiple test cases at once, and unlink them when they are no longer relevant.

AI Test Generation

Generate test cases from the GitLab issue context using AI. The extension reads the issue title and description, then produces suggested test cases that you can review, edit, and save. This is especially useful for quickly building coverage for new feature requests or bug reports.

Test Cycle Management

Create new test cycles, link test cases to cycles, and manage cycle details from the side panel. You can view all cycles associated with the current issue and navigate between them without leaving GitLab.

Test Execution

Execute test cases from the side panel. Mark steps as passed, failed, or blocked, add comments, and record results -- all within the GitLab issue view. Execution results sync back to TestKase immediately.

Requirements and Defects

When you connect a TestKase project to a GitLab project using the Chrome Extension, the mapping automatically covers both requirements and defects. There is no separate setup needed for each -- a single project mapping enables the full workflow:

• Requirements -- GitLab issues are accessible as requirement context for your test cases.
• Defects -- Defects created during test execution can be linked back to the GitLab issue.

This unified approach means you configure the connection once and get complete traceability between GitLab issues, test cases, and defects.

Troubleshooting

▶The extension side panel is not appearing on GitLab issue pages

Check the following:

1. Verify the extension is installed and enabled in chrome://extensions.
2. Make sure you are on a GitLab issue page (URL should match gitlab.com/<group>/<project>/-/issues/<number>).
3. Confirm that you have mapped a TestKase project to this GitLab project in the extension settings.
4. Try refreshing the page. If the issue persists, click the TestKase icon in the toolbar to manually open the side panel.

▶My Personal Access Token is not being accepted

Your PAT may be expired or revoked. Steps to resolve:

1. Go to TestKase Settings -> API Keys and check whether the token is still active.
2. If it has expired, generate a new token.
3. Copy the full token string (avoid leading or trailing spaces) and paste it into the extension login screen.
4. If the issue persists, try logging out of the extension and logging back in with the new token.

▶Project mapping seems lost or the extension shows the wrong project

Project mappings are stored locally in the extension. They can occasionally be cleared if:

• The extension was updated or reinstalled.
• Browser data was cleared.
• Chrome profiles were switched.

Re-open the extension settings, select your TestKase project, and re-map it to the GitLab project.

▶Actions in the side panel are slow or timing out

This is usually a network issue. Ensure you have a stable internet connection and that your TestKase instance is reachable. If you are behind a corporate VPN or firewall, verify it does not block traffic to the TestKase API.

Next Steps