# Schedule a Form

## Schedule a Form

To Schedule a form, follow the steps described described here:

{% content-ref url="/pages/ytmg6K0gCHQ8vDF1ONW3" %}
[Manual execution](/pipeline-forms/user-guides/user-guide/run-pipelines/manual-execution.md)
{% endcontent-ref %}

When Form input fields are filled, **Schedule** is the second option besides **Run Pipeline.**

<figure><img src="/files/xFLyaKzbVzCTufoJafsi" alt=""><figcaption><p>Scheduling a form</p></figcaption></figure>

A **New schedule** popup will prompt for the following details:

* **Name** - give a name that describes the behaviour. This will be used in the schedule list
* **Use latest commit on branch** - as you selected a specific commit it is important&#x20;
* that you decide whether the scheduler should use it or use the latest commit on the branch instead
* **Occurrence** - you can set up the regularity of the schedule: Hourly, Daily, Weekly

<figure><img src="/files/hs3jtsSIAlkMp4aJcoYY" alt=""><figcaption><p>New schedule dialog</p></figcaption></figure>

### Occurrence

#### **Hourly**

Hourly Occurrence will run every hour, 24 times a day.

#### Daily

When Daily Occurrence **is** selected, you can select a

* &#x20;one-hour interval, when the schedule will be executed every day of the week

<figure><img src="/files/TI1LutHSLarJYjv7HMZt" alt=""><figcaption><p>Daily occurrence</p></figcaption></figure>

#### Weekly

When Weekly Occurrence is selected, you can select a

* one hour interval
* Days of the week, when the execution will be executed every week

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

{% hint style="info" %}
Note that the selected hour range is in your time zone, while the execution is calculated in UTC.
{% endhint %}

When a schedule is set, it will be automatically added to the schedule list and will be enabled (Active) by default.

<figure><img src="/files/YPKEPY5ITJ769TQWCkt6" alt=""><figcaption><p>Schedule List</p></figcaption></figure>

When occurrence hits next time, your pipeline will be automatically executed, with your form data! :tada:

Scheduling a form will add a new entry in the Audit logs with the name: **Create schedule**.

{% hint style="success" %}
Every scheduled execution with Forms will add a record to the Execution logs.
{% endhint %}

## Manage Scheduled Forms

When a pipeline execution is scheduled, various actions can be performed on it.

{% hint style="success" %}
Every operation related to managing a Scheduled Form is visible in the Audit logs.
{% endhint %}

### Preview schedule

Clicking on the entry in the Schedule List results in a popup with the details of the schedule. This is useful when you want to check the scheduled pipeline details.&#x20;

<figure><img src="/files/Clvl7mfP30KZfknZIw8I" alt=""><figcaption><p>Preview of a scheduled pipeline</p></figcaption></figure>

The following details are displayed:

* **Name** - the name of the schedule
* **Occurrence** - occurrence type with specific details and hour range
* Selected **Branch**, **Pipeline**, **Form** (which might be deleted since, because it is version controlled)
* Selected **commit** - combined if always the latest is selected
* **Variables** entered - key-value pairs, where the key is the actual key from the Form
* **Created** and **Edited dates**&#x20;

{% hint style="success" %}
This view respects hidden fields, so passwords won't be visible here.
{% endhint %}

### Deactivate schedule

By turning the **Active** toggle off, the schedule will be deactivated.

<figure><img src="/files/oX9muIk7RvtNL2ht709Y" alt=""><figcaption><p>Turn a schedule on and off </p></figcaption></figure>

By pressing the toggle again, the schedule will be activated again :relaxed:

### Edit schedule

Before getting started with editing, it is important to understand the intention of the Edit feature, and the general behaviour of version control. When you schedule a form, it will be created as a standalone schedule with some extra variables and a set occurrence. The form itself might be deleted or drastically changed right after. So the edit feature won't include the form itself, only raw data which is stored after using a Form.

Due to this, we recommend that you consider editing a schedule for minor changes only, such as changes in variables or the schedule to avoid duplicate scheduling. For major changes, it might be a good idea to start over with scheduling a Form.

{% hint style="danger" %}
As every user can edit a schedule, this operation requires careful consideration in terms of bypassing Form constraints like a regular expression, the select fields's preset values or field types. Each stored variable can be edited separately.&#x20;

Feel free to share your feedback about this feature by contacting us through our support channels.
{% endhint %}

To edit a schedule, press the pencil in the Actions menu:

<figure><img src="/files/HWYNH26VBNA074COpSsJ" alt=""><figcaption><p>Editing a scheduled pipeline</p></figcaption></figure>

{% hint style="success" %}
This view respects hidden fields as well, so passwords are not visible, but editable here.
{% endhint %}

### Delete schedule

Deletion should be the last operation you want to use. It is suggested to deactivate a schedule first, since it is reversible, while deletion is not.

To delete a schedule, press the trash icon in the Action menu:

<figure><img src="/files/4UOh7sD0Le3vk2ulha1F" alt=""><figcaption><p>Delete a scheduled pipeline</p></figcaption></figure>

Confirm deletion, and the scheduled pipeline will be gone forever :wave:.


---

# 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.meta-inf.hu/pipeline-forms/user-guides/user-guide/run-pipelines/schedule-a-form.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.
