> For the complete documentation index, see [llms.txt](https://docs.dogq.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dogq.io/documentation/scheduling.md).

# Scheduling

In some cases you might want to continuously execute your tests at **specific time intervals** (e.g., run your regression tests every night to get the morning result) to ensure that new changes did not break the existing flows.

DogQ got you covered. You can schedule single tests, all tests in a module, or even all tests within a project. There are two ways to access scheduling settings:

* depending on whether you're on a Project show page or a Module show page, clicking <img src="/files/qjJndBvdjiDGk0lpnlO4" alt="" data-size="line"> on the buttons panel will open the scheduling options for that specific Project or Module.
* you can set up repeatable runs of individual entities via the Actions menu on the far right side of that entity (Project, Module, Scenario).

<figure><img src="/files/0uJlAi51QbHhRWddoss1" alt=""><figcaption></figcaption></figure>

### Configuring a Scheduling session

Once you have clicked **Schedule**, you'll see the following modal window:

<figure><img src="/files/TCnnaRggZ7wUWOJTdmi0" alt="" width="563"><figcaption></figcaption></figure>

### Frequency of scheduled executions

You can select one of the following **period types**:

* Minute(s)
* Hour(s)
* Day(s)
* Month(s)

For example, if you want to run your tests once an hour, you can either type in "1" and select "Hour(s)" or type "60" and select "Minute(s)" and confirm the schedule - both will produce the same result.

<figure><img src="/files/86crbVHkfwBh82x6zCOM" alt="" width="563"><figcaption></figcaption></figure>

### Start date and time

In some cases you might want your test to be run not immediately, but rather at a planned date and time. You can do exactly that by using a date and time picker or manually entering the values.

<figure><img src="/files/HVpdtdYEr4pRlMpd66E0" alt="" width="563"><figcaption></figcaption></figure>

### Number of scheduled executions

This feature allows you to set the number of times you want your tests to be run by DogQ before it stops the scheduling session.

<figure><img src="/files/TrEtOMP9Yz8VoFCXAuv7" alt="" width="563"><figcaption></figcaption></figure>

### Monitoring your scheduled tests

All your scheduled Scenarios can be monitored on the [Schedules](https://dogq.io/schedules) page.

<figure><img src="/files/LTOf5uHLgwrADKCuQNTs" alt=""><figcaption></figcaption></figure>

Additionally, all the triggered scenario executions will be available on the [Executions](https://dogq.io/executions) page and have a **Schedule** status in the "Created by" column.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.dogq.io/documentation/scheduling.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.