# Publishing Options

{% hint style="info" %}
When you upload your Colibri exercise, make sure you have a **facilitator uploaded to the space**. The exercise isn't facilitated but you need someone with privileged access to access the reports.
{% endhint %}

To make exercises available to participants, you must publish your exercise to your space. When you click `Run exercise` in your Editor, you'll be met with this window:

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

When you’re ready to publish your exercise, you have two main publishing options via a toggle:

## Empty and publish

{% hint style="warning" %}
This is the **default option**.
{% endhint %}

| Effect                    | Use when                                               |
| ------------------------- | ------------------------------------------------------ |
| Complete reset            | You're not actively running an exercise                |
| Removes all past messages | You want to start an exercise again from the beginning |

## Content only

| Effect                     | Use when                                                                 |
| -------------------------- | ------------------------------------------------------------------------ |
| Updates content only       | You're currently running an exercise                                     |
| Won't affect anything else | You need to make small corrections without affecting players in progress |

{% hint style="danger" %}
Be careful: `Content only` doesn't affect the exercise logic or sequencing so if you've edited more than just the content then use `Empty and Publish` instead.
{% endhint %}

## Publish options

These options can be selected/unselected via a checkbox.

### Reset "first log in" status

{% hint style="warning" %}
This is the **default option**.
{% endhint %}

| Effect                                                                           | Use when                                                                                             |
| -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| Ensures all players receive the "first log in" message the next time they log in | You want to run an exercises as a fresh playthrough, as if players are logging in for the first time |

{% hint style="danger" %}
Make sure players log out and back in again after resetting the "first log in" status to ensure they see the first message again.
{% endhint %}

### Publish "first log in" message

| Effect                                                        | Use when                                                  |
| ------------------------------------------------------------- | --------------------------------------------------------- |
| Publishes the "first log in" message immediately after upload | Only when testing so you don't need to log out to preview |

### Include style

{% hint style="warning" %}
This is the **default option**.
{% endhint %}

| Effect                                                                                | Use when                                                                   |
| ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| Ensures your *Style* (desktop background, favicon etc.) is uploaded with the exercise | You’ve updated or changed the *Style* and want to upload it to an exercise |

{% hint style="success" %}
Uncheck to upload the exercise without affecting the *Style*.
{% endhint %}

### Clear past messages

{% hint style="warning" %}
This is the **default option**.
{% endhint %}

| Effect                               | Use when                               |
| ------------------------------------ | -------------------------------------- |
| Clears all past messages for players | You want players to see an empty inbox |

{% hint style="success" %}
Unselect if you want to avoid interrupting players who are still mid-exercise.
{% endhint %}

## Reset personas

These options control what happens to your personas when you publish:

| Persona option | Description                                                                                                                        |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Reset**      | All online exercise personas are erased and re-uploaded                                                                            |
| **Update**     | Existing personas created during a live exercise remain. However, any persona that matches one in your scenario may be overwritten |


---

# 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://helpdocs.conducttr.com/colibri/publishing-and-delivery/publishing-options.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.
