# Create a Test Scope

Create a **Test Scope** to start organizing testing for a feature, module, or release item. A scope acts as the workspace where requirements, test cases, and execution results are grouped together.

### Steps to Create a New Scope

{% stepper %}
{% step %}
Open Test Scopes in the left navigation
{% endstep %}

{% step %}
Click + New Test Scope
{% endstep %}

{% step %}
(Optional) Upload source files 
{% endstep %}

{% step %}
Enter a Scope Title

*<mark style="color:$info;">(TestFirst can automatically generate a title when files are uploaded.)</mark>*
{% endstep %}

{% step %}
Select a Project

*<mark style="color:$info;">(TestFirst can generate a new project from uploaded sources.)</mark>*
{% endstep %}

{% step %}
Click Create
{% endstep %}

{% step %}
(Optional) [Generate Test Cases](https://docs.testfirst.com/test-scopes/prepare-test-cases)

* Review & select test cases when test cases are generated.&#x20;
* Click Add.
  {% endstep %}
  {% endstepper %}

New test cope will be created and the scope detail page will appear on the page.

***

### Upload Source Files

Source files provide product context that can later be used to generate testing artifacts. You can upload files when creating a scope or add them later from the scope detail page.

To upload files:

1. Open the **Test Scope Detail Page**.
2. Scroll to the **Sources** section, click number of sources link.&#x20;
3. **Upload Files** or drag and drop files in Test Scope Sources modal.

The **AI Capacity Bar** updates as files are added.

### Manage Source Files

From the **Sources** section you can also:

* Download existing files
* Delete files&#x20;

These actions allow teams to update the product context as requirements evolve.

### Supported File Types

The following file types are supported:

* `.txt`
* `.md`
* `.docx`
* `.pdf`

{% hint style="info" %}
Demo files can also be uploaded for testing purposes.
{% endhint %}

### Source File Rules

When uploading files:

* Maximum size: **30 MB per file**
* Duplicate files are **blocked**
* Empty files are **rejected**

These checks ensure uploaded files can be processed correctly.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.testfirst.com/test-scopes/create-a-test-scope.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.