Import CucumberStudio Scenarios

Applies to TestComplete 15.61, last modified on February 27, 2024

With TestComplete, you can automate BDD scenarios you created and run in CucumberStudio.

CucumberStudio is a collaborative testing cloud platform for large and small software development and software delivery teams. It is helpful for all team members: product managers, QA engineers, developers, subject matter experts, and even customers. CucumberStudio includes a special editor, Gherkin, where you can easily create BDD scenarios. To learn more, please visit the CucumberStudio website.


You need an active CucumberStudio account. If you don’t have one, you can create a free account during the import.

Import CucumberStudio project

You can import CucumberStudio test scenarios when you are creating a new project in TestComplete:

  1. From the main menu of TestComplete, select File > New > New Project. This will invoke the New Project wizard.

  2. On the first page of the wizard, specify the project name and project suite, and select the BDD files check box and click Next:

    Import CucumberStudio project: Step 1

    Don’t select DelphiScript for your project. Choose any other scripting language. DelphiScript doesn’t support BDD.

  3. On the next page, select Import a project from CucumberStudio. Then specify the credentials you use to connect to CucumberStudio:

    Import CucumberStudio project: Step 2

    If you don’t have an account, click Create a new CucumberStudio account. After you signed up, enter your email and password in the wizard.

    If you log in to CucumberStudio by using your GitHub or Google account, you need to generate special API credentials in CucumberStudio, and then specify them in the wizard. See Login With GitHub or Google Credentials for details.

    We would recommend selecting the Remember login credentials check box. In this case, TestComplete will save the email and password on your computer, use it for synchronizing BDD scenarios, and post information on test runs to the CucumberStudio database.

    Click Next.

  4. On the next page, you need to select a BDD CucumberStudio project, from which you would like to import BDD scenarios, and then click Finish.

    CucumberStudio supports both BDD and non-BDD test projects. You should select a BDD test project.

    Import CucumberStudio project: Step 3

What happens then

  • TestComplete will retrieve feature files with scenarios from CucumberStudio and import these feature files into your project. After the import is over, you will see these files in the Project Explorer under the Scenarios node (if your project doesn’t have this node, TestComplete will create it):

    Imported CucumberStudio scenarios in the Project Explorer

    TestComplete imports features and scenarios along with their tags.

    If your scenarios are organized in folders in CucumberStudio, TestComplete will organize the imported feature files into folders, as well.

  • TestComplete will also create script functions for test steps of BDD scenarios in the imported feature files. This will make further automation faster and easier.

  • By importing CucumberStudio scenarios, you bind your TestComplete project to the CucumberStudio project you selected during the import. This means that –

    • By default, TestComplete will update imported scenarios from the linked CucumberStudio project automatically when you open your test project in TestComplete, or before you run BDD scenarios in TestComplete.

      TestComplete will also upload the changes you made to BDD scenarios and feature files in TestComplete to CucumberStudio. See Synchronize Scenarios for complete information.

    • Also, TestComplete will post test results to the CucumberStudio project when you run BDD scenarios from TestComplete. See Upload Results.

Further steps

  • After you imported BDD scenarios, you need to create script code that will run when you launch these scenarios. You do this by writing script statements into the function definitions that TestComplete generated during the import. You can write the code manually or record it, if possible.

  • You can then run BDD scenarios from TestComplete. When you do this for BDD scenarios bound to a CucumberStudio project, then, by default, the test engine posts the test run results to CucumberStudio, so, you can view automated run results along with other results in CucumberStudio. You can disable this functionality, if needed. See Upload Results.

See Also

CucumberStudio Integration

Highlight search results