Chrome extension

Guide on the Ketryx Chrome extension

1. Introduction

The Ketryx Chrome extension provides a seamless way to navigate between TestRail and Ketryx, enhancing your workflow efficiency. This extension allows you to:

• Quickly access Ketryx records directly from TestRail

• Configure custom TestRail instance URLs for self-hosted environments

• Maintain a consistent workflow between both platforms

This guide provides step-by-step instructions for installing, configuring, and using the Chrome extension.

2. Installation and Setup

To install and set up the Ketryx Chrome extension:

1. Open the Chrome Web Store and search for "Ketryx" (or use this link)

2. Click "Add to Chrome" to install the extension

3. Click the extension icon in your Chrome toolbar

4. Click on the options page

5. Configure your settings:

   • Enter your Ketryx instance URL

   • (Optional) Enter your custom TestRail instance URL if using a self-hosted version

   • Save your settings

3. Using the Extension

3.1. Basic Navigation

When viewing a TestRail test case, test run or testplan:

1. The extension automatically detects the current TestRail record

2. A "See in Ketryx" button appears in the TestRail interface

3. Click the button to open the corresponding record in Ketryx in a new tab

3.2. Configuration Options

The extension provides the following configuration options:

• TestRail Instance URL: (Optional) Custom URL for self-hosted TestRail instances

4. Frequently Asked Questions

4.1. Q: How do I update my TestRail instance URL?

1. Click the extension icon in your Chrome toolbar

2. Click "open options page"

3. Update the TestRail Instance URL field

4. Click Save

4.2. Q: The extension isn't detecting my TestRail records. What should I do?

• Ensure you're logged into both TestRail and Ketryx

• Verify that your TestRail instance URL is correctly configured

• Check if your Ketryx project has been correctly synced

4.3. Q: The extension opens the projects page

This can happen when we don't find the item, make sure you are in a project that is being synced to Ketryx, and force the sync to make sure you have all the latest items.

5. Security and Privacy

The Ketryx Chrome extension:

• Only stores configuration data locally

• Does not collect or transmit personal information