# Working within Events

Events in the mobile app work similarly to [on a computer](/concepts-and-fundamentals/on-a-computer/working-with-events.md) with some exceptions.

Mobile users:

* are required to go on duty to at least one primary event before using it
* who wish to go on duty to multiple events must do so one event at a time
* who are System Administrators and manage events have limited tools for this in the mobile app.

{% hint style="info" %}
It is best practice in the mobile app to only go on duty to the Events with the Positions that you need. Having too many duties may cause confusion and have unintended effects.
{% endhint %}

{% hint style="info" %}
Some mobile app users can Create an Event, however may not be able to view or manage them like they could on a computer.
{% endhint %}

## Selecting an Event <a href="#events-menu" id="events-menu"></a>

In order to use the app, you'll need to select an event. To do this, use the Go to Event Selection <img src="/files/cgpMYIB5UEEBoD25QwJ4" alt="" data-size="line"> button.

<figure><img src="/files/WLUfTkNiICD05sVqW00E" alt=""><figcaption><p>Go to Event Selection button</p></figcaption></figure>

### Events Selection Screen

The Events Selection Screen is divided into two sections:

* [Joined Events](#joined-events) - any Events you're already on duty to. If you've not yet joined any Events, you will not see this section.
* [Active Events](#active-events) - other available Events

Each section section shows the total number of Events found and list duties in an expandable section. By default these are collapsed and will give you a total positions that you're on duty for or that are available.

A:

* green message means on duty, total positions you're on duty for are displayed
* red message means off duty, total positions that are available to you are displayed

<figure><img src="/files/uFSKc1WjamhKDvjjEkyN" alt=""><figcaption><p>Your current duties can be expanded using the right arrow</p></figcaption></figure>

To expand the section and change these Position(s) use the right arrow ![](/files/QRfIrnwXan9stULja4kV).

To collapse them with the down arrow ![](/files/Ny0Wg4ANKiDelhU0AsBb). Unticking them all individually or the All Positions box will put you off duty, which will change the message to red.

#### Joined Events

If you've already gone on duty to some events this section tells you exactly which and when along with any Position(s) that currently apply.

#### Active Events

The Active Events screen is whereevents that your account's Position has access can be found (this is controlled by your administrator refer to: [Managing Events](/system-administration/managing-events.md)).

To find an Event, start typing its name into the **Search events** box. If you don't know the Event's name, ask your System Administrator or Coordinator.

<figure><img src="/files/0cnNtyJAAidGPHlihf9K" alt="" width="333"><figcaption><p>Event selection with primary event indicated next to the hamburger menu</p></figcaption></figure>

If you're finding the Event you need to work with isn't there, try the Refresh Events <img src="/files/ZULAhLqr7Yvirw0C9zlG" alt="" data-size="line">button at the bottom of the screen or contact your administrator.

### Primary Event

The primary event is the one you have selected, determines where records will be added, is displayed at all times on the top left next to the hamburger menu.

### Selecting a new Primary Event (Switching between Events) <a href="#selecting-a-primary-event" id="selecting-a-primary-event"></a>

To select an Event as a Primary Event:

1. Go to the [Events Selection Screen](#events-menu)
2. Next to the Event you wish to make primary, use the Select <img src="/files/8eD7nSv7LlsMm2nGEn6q" alt="" data-size="line"> button

## Joining Events

1. Navigate to the [Events Selection screen](#events-menu)
2. In Joined Events:
   1. To select individual duties - Expand, tick the Position(s) that you want to go on duty with (tick 'All Positions' to tick all). Use the Update Duties <img src="/files/nVML6ZeXP6RH1oYkXPxH" alt="" data-size="line"> button at the bottom of the screen OR
   2. To select all duties use the Join <img src="/files/bzLlDY5tBOxzMqWT2wOx" alt="" data-size="line">button. There is no need to update duties when using the Join button as the system does this for you.

## Leaving Events

There are two main ways to leave an Event:

* Leaving Events Individually, and:
* Leaving All Events

#### Leaving Events Individually

1. Navigate to the [Events Selection screen](#events-menu)
2. In Joined Events, expand, untick the Position(s) you want to go off duty for
3. Use the Update Duties <img src="/files/nVML6ZeXP6RH1oYkXPxH" alt="" data-size="line">button at the bottom of the screen

#### Leaving All Events

To leave all Events:

1. Navigate to the [Events Selection screen](#events-menu)
   1. Untick All Positions, use the Update Duties <img src="/files/nVML6ZeXP6RH1oYkXPxH" alt="" data-size="line"> button at the bottom of the screen and repeat for all Events OR
   2. Use the Leave All Events <img src="/files/pbahwWH3JEHLTARYKKmM" alt="" data-size="line"> button at the bottom of the screen

## Creating an Event

Some Position(s) allow users to create an Event. Users with this permission will see a Create Event section at the bottom of the screen.

The process is the same as [on a computer](/system-administration/managing-events.md#creating-a-new-event) requiring an **Event Title**, **Event Description**, **Template and** as well as an optional **Event Description,** **Start Date** and **End Date**. Complete the process using the Create <img src="/files/6lZ5alJrFjQH23O4Nrko" alt="" data-size="line"> button.

<figure><img src="/files/KPfSVsc9FfyGaCFViXf1" alt=""><figcaption><p>Create an Event section</p></figcaption></figure>

<figure><img src="/files/HZpFMnI7IFxvwpqeK7xs" alt="" width="129"><figcaption><p>Create Event screen</p></figcaption></figure>


---

# 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.cw.crisisworks.com/concepts-and-fundamentals/mobile-app/working-within-events.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.
