--- title: TestRail slug: suite-documentation/testrail docTags: createdAt: 2025-11-16T18:11:25.693Z --- **TEST RAIL PLUGIN - CLOUD** - Create a new account or log in to your Test Rail account with https\://www\.testrail.com/ - Go to **Administration** -> **Site Settings** -> **API**. **Select Enable API** and save settings. ![](https://testinium.gitbook.io/testinium/~gitbook/image?url=https%3A%2F%2F3406521835-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Flc2ZPm2EZqQaZb9sLBL9%252Fuploads%252FKh9vtWg78f723x7IjXe3%252FScreenshot%25202025-03-04%2520at%252010.33.40.png%3Falt%3Dmedia%26token%3Db248c2a6-03dd-498d-930c-bd2e4155d809\&width=768\&dpr=4\&quality=100\&sign=15623b9c\&sv=2) 3. Go to Testinium. Go to **Account Information** -> **Plugins.** ![](https://testinium.gitbook.io/testinium/~gitbook/image?url=https%3A%2F%2F3406521835-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Flc2ZPm2EZqQaZb9sLBL9%252Fuploads%252FbfWdYMvzQthqBrCPzNUK%252FScreenshot%25202025-03-10%2520at%252023.44.12.png%3Falt%3Dmedia%26token%3D431c8e3a-05e5-4882-96f2-1dceb020b8cb\&width=768\&dpr=4\&quality=100\&sign=db0829f9\&sv=2) 4. Click the Edit button of the **Test Rail Plugin.** ![](https://testinium.gitbook.io/testinium/~gitbook/image?url=https%3A%2F%2F3406521835-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Flc2ZPm2EZqQaZb9sLBL9%252Fuploads%252FyqtukS06A4gEkupIgxBz%252FScreenshot%25202025-03-10%2520at%252023.46.10.png%3Falt%3Dmedia%26token%3D6b8a67e1-05fc-4415-b1fd-59a3b0307dd3\&width=768\&dpr=4\&quality=100\&sign=9af5462d\&sv=2) 5. **TEST RAIL SERVER URL\*** should be something like username.testrail.io ![](https://testinium.gitbook.io/testinium/~gitbook/image?url=https%3A%2F%2F3406521835-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Flc2ZPm2EZqQaZb9sLBL9%252Fuploads%252Fc49IY9QomxuYgOvHizu9%252FScreenshot%25202025-03-10%2520at%252023.48.36.png%3Falt%3Dmedia%26token%3D7807cf06-6017-43f5-a451-37c9052ffb11\&width=768\&dpr=4\&quality=100\&sign=130d8039\&sv=2) - Give your **TEST RAIL USERNAME** and **PASSWORD.** Click **SAVE**. - Go to the project you want to use with Test Rail Plugin. - Click **Summary** and go to the **Advanced** section of the project. ![](https://testinium.gitbook.io/testinium/~gitbook/image?url=https%3A%2F%2F3406521835-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Flc2ZPm2EZqQaZb9sLBL9%252Fuploads%252F8gh8Msy5Fkcj07VW8ofI%252FScreenshot%25202025-03-10%2520at%252023.53.04.png%3Falt%3Dmedia%26token%3Df5613d83-c329-437b-b9b2-642118b289c8\&width=768\&dpr=4\&quality=100\&sign=eb961fbb\&sv=2) 6. **Enable Test Rail** and select the Test Rail project you want to use with Testinium. Click **Apply** and **Save**. ![](https://testinium.gitbook.io/testinium/~gitbook/image?url=https%3A%2F%2F3406521835-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Flc2ZPm2EZqQaZb9sLBL9%252Fuploads%252FXDnzbVAkcgRR0ALkayn1%252FScreenshot%25202025-03-10%2520at%252023.58.40.png%3Falt%3Dmedia%26token%3Dbef6e1ec-fadb-4f36-a3b4-3200341831dc\&width=768\&dpr=4\&quality=100\&sign=c661ddbd\&sv=2) 7. Enter TestRail case id when creating new scenario. Plugins area (Figure 8) will be shown after select project. ![](https://testinium.gitbook.io/testinium/~gitbook/image?url=https%3A%2F%2F3406521835-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Flc2ZPm2EZqQaZb9sLBL9%252Fuploads%252Fh7JzRFIL16svtk3ZHCcp%252FScreenshot%25202025-03-11%2520at%252000.07.59.png%3Falt%3Dmedia%26token%3D952081ac-fdf5-4a6a-8c15-9ac2da96e2cc\&width=768\&dpr=4\&quality=100\&sign=c07dd7dc\&sv=2) 8. Go to the plan you want to use with Test Rail Plugin. ![](https://testinium.gitbook.io/testinium/~gitbook/image?url=https%3A%2F%2F3406521835-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Flc2ZPm2EZqQaZb9sLBL9%252Fuploads%252Fqc51BNcl0CjLaiGSs2um%252FScreenshot%25202025-03-11%2520at%252000.11.38.png%3Falt%3Dmedia%26token%3D45e5afd2-8665-4a54-9129-a85d8dcf7331\&width=768\&dpr=4\&quality=100\&sign=a0a5ec25\&sv=2) 9. If you would like to associate the test execution with a **TestRail Milestone** and a **TestRail Test Plan**, you may optionally select them from the respective dropdown menus. On the **Plan Edit - Advanced Settings** page, selecting a **TestRail Suite** is mandatory to enable TestRail integration. ![](https://testinium.gitbook.io/testinium/~gitbook/image?url=https%3A%2F%2F3406521835-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Flc2ZPm2EZqQaZb9sLBL9%252Fuploads%252FBPEgg9eOGB1zU60zvlxq%252FScreenshot%25202025-03-11%2520at%252000.10.40.png%3Falt%3Dmedia%26token%3Dfd35a065-613d-444f-9aa5-e729b5c089f8\&width=768\&dpr=4\&quality=100\&sign=11bbd8b5\&sv=2) 10. Run a suite belongs to the project. Test result should be received in your Test Rail account with the selected project in the **Test Runs & Results** section. ![](https://testinium.gitbook.io/testinium/~gitbook/image?url=https%3A%2F%2F3406521835-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Flc2ZPm2EZqQaZb9sLBL9%252Fuploads%252FtXJCfoQYbecwHZgPEKlF%252FScreenshot%25202025-03-11%2520at%252000.13.20.png%3Falt%3Dmedia%26token%3D1de9f914-8bf4-4a62-972f-1410aedaeb3e\&width=768\&dpr=4\&quality=100\&sign=b24c8c62\&sv=2) ![](https://testinium.gitbook.io/testinium/~gitbook/image?url=https%3A%2F%2F3406521835-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Flc2ZPm2EZqQaZb9sLBL9%252Fuploads%252Fgit-blob-5a5ffbfacc0083376d4d5e4be901810d282e8c34%252F10%2520%283%29%3Falt%3Dmedia\&width=768\&dpr=4\&quality=100\&sign=3e38b184\&sv=2)