# Status Transitions

## What is Status Transitions

By status transitions we mean the transitions you will find under the Status dropdown in many of the drawers. Below is a screenshot from Voyage drawer.

<figure><img src="/files/1YazSnHciBrnT1jiTePO" alt=""><figcaption></figcaption></figure>

## Giving access to the status transitions for users

The access to status transitions is controlled by the Security Permissions. The permissions are organised under entities i.e Voyage, Cargo etc. and the status transition permissions are named following `FromStatus-ToStatus` pattern.

Referring to below screenshot, this security role has only access to two status transitions on Voyage, from Allocated to Nominated and from Estimate to Nominated.

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

By default no users will have access to any of the status transitions. Users within Administrator security group will have access to all existing status transitions.&#x20;

Giving access to the status transitions can be done by users within Administrator or User Provisioning security group.&#x20;

Access can be given in two ways:

1. Adding the access to an existing security group<br>
   * go to Setup > Security Roles
   * locate the security role you want to change and click on it to open it in a drawer
   * locate and expand the entity you want the user to have access to to list all the permissions
   * check the permissions you want the user to have access to<br>
2. Creating a new security group with the necessary permissions<br>
   * go to Setup > Security Roles
   * click on Create a security role button
   * locate and expand the entity you want the user to have access to to list all the permissions
   * check the permissions you want the user to have access to
   * click Create
   * go to Setup > Security Groups
   * create a security group with the new security role
   * add the new security group to the users security groups

Once the status transition setup is complete the user will see the status transitions they have access to in the status transition dropdown.


---

# 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.dataloy.com/voyage-management-system/step-by-step-guides/status-transitions.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.