---
title: Create Spec File
slug: suite-documentation/create-spec-file
docTags: 
createdAt: 2025-12-02T22:10:32.003Z
---

Create Spec File directs the user to the page where a new spec file is created.Spec files are the main files containing the test cases. It can include more than one scenario.The following steps are followed to create a spec file;

1. Select project from BDD File List page.
2. Click the Create Spec File button.

![](https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=988798422/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fz8xU8NRvPGqgBhcaWC4z%252Fuploads%252FMMa7WwlDr9d44PAumvo7%252FScreenshot%25202025-03-07%2520at%252021.14.08.png%3Falt%3Dmedia%26token%3D71d9015c-f0f4-456e-bfe6-466bb09b0b93)

3. Enter the file name.

![](https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=506983470/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fz8xU8NRvPGqgBhcaWC4z%252Fuploads%252Fk54SoxkaIkV6TaZTduVG%252FScreenshot%25202025-03-07%2520at%252021.11.55.png%3Falt%3Dmedia%26token%3De25e6d03-a911-4a59-82e0-e224316878e5)

4. Scenario can be added to the spec file to be created. Click Click the New Scenario button on the BDD Editor screen for this.

:::hint{type="info"}
The spec file can be saved without adding a scenario.
:::

5. Enter the Scenario name.
6. Add Tag.

:::hint{type="info"}
Tag field is required.

Tag must start with '@'
:::

![](https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=99426413/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fz8xU8NRvPGqgBhcaWC4z%252Fuploads%252FBcek24GdRllYeiZHxCBs%252FScreenshot%25202025-03-10%2520at%252017.01.39.png%3Falt%3Dmedia%26token%3D73b7c214-731d-4f12-acfd-6ea0a32cb72d)

7. a. Click on the New Tag button to add a new tag.

:::Paragraph{indent="1"}
b. Click on the New Test Step button to add a test step
:::

![](https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=-766758959/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fz8xU8NRvPGqgBhcaWC4z%252Fuploads%252F6PiilxDZ8v9UIMpODPMN%252FScreenshot%25202025-03-10%2520at%252016.41.03.png%3Falt%3Dmedia%26token%3D04824cbe-a12a-4265-9c41-2d606d92ebfe)

8. a. Click the Save button to save spec file.

:::Paragraph{indent="1"}
b. Click the Cancel button to cancel the adding process.
:::