# 7. Programs - custom ways to temporarily run your pool

## 7.1 What are programs

{% hint style="warning" %}
Programs override all pool equipment in operation if they are run. They take precedence over schedules, manual operation and autopilot
{% endhint %}

Programs are used when you would like to run your pool in a certain way temporarily. A great use case is Spa Mode. As an example, normally you want your pool filtering your pool water like normal, but you want to allow the user to turn their spa on for a few hours to enjoy. Programs are unique in that they can override specific pieces of equipment at a time. We'll show you a couple of examples how a program could leave schedules running on a pump, but turn on a booster pump and a valve to do a special water feature.

## 7.2 Creating your first program

To create a program like Spa Mode, click the "Programs" button on the home screen. Then click add.

{% hint style="info" %}
Note, if you already see a couple of programs there, that's fine. Clyr will automatically create some programs as certain pieces of equipment are added like pumps. These programs can be edited or archived if you don't want them.
{% endhint %}

<figure><img src="/files/9VQYawX8jXLh1LbtbstL" alt="" width="291"><figcaption></figcaption></figure>

In the example above, we've created a program called **Test** to run for 30 minutes. It will turn on our single valve actuator pointed in the "Spa" direction and it will also enable Aux2 relay.

{% hint style="warning" %}
To reiterate, in the program above, Aux 3, Heater, and Relay light, will maintain whatever functionality has been programmed. This means that these components could run manually, with a schedule, or even another program because they're not being used by this program.
{% endhint %}

After saving this program, it will show up on the programs page.

## 7.3 Pinning Programs

Let's say you are programming a spa mode and want easy access to it on the home screen. From the programs page, click "Add to Home". This will make a button show up on the home screen just below "Water Quality" items.

<figure><img src="/files/WwALOOVBnGHhQmJ0gnZY" alt="" width="287"><figcaption></figcaption></figure>

<figure><img src="/files/6rwuh5kv8UgNbbm4dtTB" alt="" width="289"><figcaption></figcaption></figure>

## 7.4 Running programs

All you need to do to run the program is click the button. It may take a few seconds to activate but then you should see a progress bar and stop button. Programs can be stopped at any time or they will run for the programmed duration.


---

# 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.clyrpool.com/using-the-clyr-app/7.-programs-custom-ways-to-temporarily-run-your-pool.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.