> ## Documentation Index
> Fetch the complete documentation index at: https://docs.altoura.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Authoring Procedures

> Build and maintain procedures in Edit Mode: structure tasks, define steps, add decision logic, and enrich content.

## Overview

Authoring is the process of building and maintaining procedures in Altoura Frontline.

In Authoring mode, you structure tasks, define steps, add decision logic, and enrich steps with media and 3D content.
All authoring is done in **Edit Mode**, which auto-saves your changes as you work.

***

## Entering Edit Mode

### Step-by-Step Instructions

1. Open the **Procedures** page.
2. Locate the procedure you want to work on.
3. Hover over the procedure card and select the **Edit** (pencil) icon.

### What Happens Next

The procedure opens in **Edit Mode** in a three-panel layout, where all changes can be made.

<Frame>
  <img src="https://mintcdn.com/altoura-785c3552/HhZQY2b4kA6oBKtL/frontline/images/procedures-portal/author-in-the-portal/portal-authoring-full-layout.png?fit=max&auto=format&n=HhZQY2b4kA6oBKtL&q=85&s=5db2885ca320c39d64e05e72588029af" alt="The full Edit Mode layout showing the Procedure Tasks panel on the left, the Step Editor in the center with the current step, and the Assets panel on the right with the System tab open showing asset categories." noZoom width="3168" height="1813" data-path="frontline/images/procedures-portal/author-in-the-portal/portal-authoring-full-layout.png" />
</Frame>

<Tip>
  Use the **Run** button in the top-right of Edit Mode to launch [Run Mode](/frontline/procedures-portal/run-mode) at any time and test your procedure without leaving the editor.
</Tip>

***

## Authoring Layout

Edit Mode is organized into three main areas:

<CardGroup cols={3}>
  <Card title="Procedure Tasks (Left Panel)">
    Used to manage tasks and steps. Shows the structure and flow of the procedure. Supports reordering and quick navigation.
  </Card>

  <Card title="Step Editor (Center)">
    Displays the selected step. Used to author step text and view how it will appear during execution.
  </Card>

  <Card title="Assets Panel (Right)">
    Used to browse, upload, and manage media and 3D assets. Includes **System**, **Custom**, and **Properties** tabs.
  </Card>
</CardGroup>

Changes are saved automatically. A **Saving…** indicator appears in the top-right while changes are being persisted.

***

## Working with Tasks

Tasks group related steps together and help organize longer procedures.

Each task in the **Procedure Tasks** panel shows:

* A **drag handle** (six-dot icon) for reordering
* The task name
* A **step count badge** indicating the number of steps the task contains
* A **three-dot menu** for task actions

### Open the Task Menu

Select the **three-dot icon** on the right of a task to open the task menu. The menu includes **Rename Task**, **Add Task**, **Duplicate Task**, and **Delete Task**.

<Frame>
  <img src="https://mintcdn.com/altoura-785c3552/HhZQY2b4kA6oBKtL/frontline/images/procedures-portal/author-in-the-portal/portal-task-menu.png?fit=max&auto=format&n=HhZQY2b4kA6oBKtL&q=85&s=00b5a8f479050435e4ac152bc78cf6bb" alt="The task menu opened from a task's three-dot icon, showing Rename Task, Add Task, Duplicate Task, and Delete Task options." noZoom width="907" height="740" data-path="frontline/images/procedures-portal/author-in-the-portal/portal-task-menu.png" />
</Frame>

### Add a Task

1. Open the task menu of any existing task, or scroll to the bottom of the task list.
2. Select **Add Task**.
3. A new empty task is created at the end of the list with a single empty step, ready for content.

<Frame>
  <img src="https://mintcdn.com/altoura-785c3552/HhZQY2b4kA6oBKtL/frontline/images/procedures-portal/author-in-the-portal/portal-new-empty-task.png?fit=max&auto=format&n=HhZQY2b4kA6oBKtL&q=85&s=eecf4624958e71d891e624a5bb033da9" alt="A newly created Task 5 with a single empty Step 1 marked 'No content' and an Add Step button at the bottom." noZoom width="913" height="639" data-path="frontline/images/procedures-portal/author-in-the-portal/portal-new-empty-task.png" />
</Frame>

### Rename a Task

1. Open the task menu.
2. Select **Rename Task**.
3. Enter a new name and confirm.

<Frame>
  <img src="https://mintcdn.com/altoura-785c3552/HhZQY2b4kA6oBKtL/frontline/images/procedures-portal/author-in-the-portal/portal-task-rename.png?fit=max&auto=format&n=HhZQY2b4kA6oBKtL&q=85&s=e2bd96b3b93a5bef86931160435c6c6e" alt="A task with its name shown in an editable input field, ready for renaming." noZoom width="922" height="650" data-path="frontline/images/procedures-portal/author-in-the-portal/portal-task-rename.png" />
</Frame>

### Duplicate a Task

1. Open the task menu.
2. Select **Duplicate Task**.
3. A copy of the task and all its steps is created and added to the list.

### Delete a Task

1. Open the task menu.
2. Select **Delete Task** (shown in red).
3. Confirm the deletion in the **Delete Task** dialog.

<Frame>
  <img src="https://mintcdn.com/altoura-785c3552/HhZQY2b4kA6oBKtL/frontline/images/procedures-portal/author-in-the-portal/portal-delete-task-confirmation.png?fit=max&auto=format&n=HhZQY2b4kA6oBKtL&q=85&s=2728f9139e8bb32ebd4522c6ebee3009" alt="Delete Task confirmation dialog asking 'Are you sure you want to delete this task?' with the task name shown and Cancel and Yes buttons." noZoom width="3178" height="1817" data-path="frontline/images/procedures-portal/author-in-the-portal/portal-delete-task-confirmation.png" />
</Frame>

<Warning>
  Deleting a task removes all steps inside it. This action cannot be undone.
</Warning>

***

## Working with Steps

Steps define the actual instructions or decisions within a task. Newly added steps show a **No content** placeholder until you add text.

### Add a Step

1. Expand a task.
2. Select **+ Add Step**.
3. Choose a step type from the dropdown:
   * **Regular Step**: Standard procedure step
   * **Question Step**: Decision point with multiple options
   * **Final Step**: Completion step

The step is added to the task at the end of the list.

<Frame>
  <img src="https://mintcdn.com/altoura-785c3552/HhZQY2b4kA6oBKtL/frontline/images/procedures-portal/author-in-the-portal/portal-add-step-dropdown.png?fit=max&auto=format&n=HhZQY2b4kA6oBKtL&q=85&s=66ffd2deb93565a315bb46ef7c78289a" alt="The Add Step dropdown showing the three step type options: Regular Step, Question Step, and Final Step, each with a short description." noZoom width="917" height="935" data-path="frontline/images/procedures-portal/author-in-the-portal/portal-add-step-dropdown.png" />
</Frame>

### Edit Step Content

1. Select a step in the **Procedure Tasks** panel.
2. Click inside the **Step Editor** in the center.
3. Enter or update the step text.
4. Press **Ctrl + Enter** (or select **Save**) to save your changes, or press **Escape** to cancel.

<Frame>
  <img src="https://mintcdn.com/altoura-785c3552/HhZQY2b4kA6oBKtL/frontline/images/procedures-portal/author-in-the-portal/portal-step-content-editor.png?fit=max&auto=format&n=HhZQY2b4kA6oBKtL&q=85&s=f0d35486e3aa70c751079eaef808dcd5" alt="The Step Editor with an editable text field showing 'Turn OFF the toggle switch', a Save button, and the keyboard shortcut hint 'Press Ctrl+Enter to save, Escape to cancel'. The Media panel and 3D parts grid are visible below the editor." noZoom width="1769" height="1611" data-path="frontline/images/procedures-portal/author-in-the-portal/portal-step-content-editor.png" />
</Frame>

### Reorder Steps

1. Use the **drag handle** (six-dot icon) next to a step.
2. Drag and drop to change the order.

Step order defines the execution flow.

### Duplicate or Delete a Step

1. Open the step menu.
2. Choose **Duplicate Step** or **Delete Step**.

***

## Enrich a Step with Media and 3D

Each step can include images, video, and 3D parts. These appear inside the Step Editor and are also visible during execution in Run Mode.

The **Media panel** (bottom-left of the Step Editor) shows images or video attached to the current step. The **3D parts** grid next to it shows 3D assets attached to the step.

<Frame>
  <img src="https://mintcdn.com/altoura-785c3552/HhZQY2b4kA6oBKtL/frontline/images/procedures-portal/author-in-the-portal/portal-media-and-3d-panel.png?fit=max&auto=format&n=HhZQY2b4kA6oBKtL&q=85&s=bebad54796c41426b7bec9c8a87f5e8e" alt="The Media panel showing a video thumbnail with a 'Click to play' overlay, alongside the 3D parts grid containing multiple 3D model tiles." noZoom width="1764" height="566" data-path="frontline/images/procedures-portal/author-in-the-portal/portal-media-and-3d-panel.png" />
</Frame>

To browse and attach assets, use the **Assets panel** on the right of Edit Mode, which is organized into:

* **System**: Built-in assets (Arrows, Generic Tools, and other categories)
* **Custom**: Assets uploaded for your organization
* **Properties**: Properties of the currently selected step or element

***

## Step Types

### Regular Step

Used for standard, linear instructions.

**Use when:**

* The workflow follows a fixed sequence
* No decision is required

### Question Step (Choice Step)

Used to create decision points in a procedure.

A Question Step includes:

* A question or prompt
* Multiple response options
* A destination step for each response

<Frame>
  <img src="https://mintcdn.com/altoura-785c3552/HhZQY2b4kA6oBKtL/frontline/images/procedures-portal/author-in-the-portal/portal-question-step-empty.png?fit=max&auto=format&n=HhZQY2b4kA6oBKtL&q=85&s=092346a03edcad28c2dcd1e7dbde27ed" alt="An empty Question Step in the Step Editor showing 'Click to add a question…' and three blank Response rows. The matching step in the task list shows a '3 choices' tag and a warning icon indicating destinations have not been set." noZoom width="3169" height="1817" data-path="frontline/images/procedures-portal/author-in-the-portal/portal-question-step-empty.png" />
</Frame>

#### Configure Question Steps

For each response option:

1. Select the response in the Step Editor.
2. In the **Response Properties** panel on the right, enter a **Label** (what the user sees, up to 20 characters).
3. Open the **Destination** dropdown and select the step the response should route to. Destinations are grouped by task to make navigation easier.
4. Review the routing in the **Target Step Preview**.

<Frame>
  <img src="https://mintcdn.com/altoura-785c3552/HhZQY2b4kA6oBKtL/frontline/images/procedures-portal/author-in-the-portal/portal-question-step-destination-dropdown.png?fit=max&auto=format&n=HhZQY2b4kA6oBKtL&q=85&s=48fceb5545aa316f7cf570bc38aaaf08" alt="The Response Properties panel on the right showing a Label field with a 20-character limit and an open Destination dropdown listing destination steps grouped by their parent task." noZoom width="3178" height="1815" data-path="frontline/images/procedures-portal/author-in-the-portal/portal-question-step-destination-dropdown.png" />
</Frame>

Each response routes the user to the selected step during execution.

<Warning>
  Question Steps without destinations show a warning indicator in the task list and must be completed before execution.
</Warning>

### Final Step

Used to mark the completion of a procedure. A Final Step displays a success message to the user when reached.

**Use when:**

* The procedure ends
* You want to show a success or completion message

Final Steps do not lead to additional steps.

<Frame>
  <img src="https://mintcdn.com/altoura-785c3552/HhZQY2b4kA6oBKtL/frontline/images/procedures-portal/author-in-the-portal/portal-final-step.png?fit=max&auto=format&n=HhZQY2b4kA6oBKtL&q=85&s=7c3a73c8ee7ef555281c9b12b9aa5669" alt="A Final Step in the Step Editor displaying a trophy icon and the completion message 'Congratulations! You have successfully completed this Procedure.'." noZoom width="3175" height="1818" data-path="frontline/images/procedures-portal/author-in-the-portal/portal-final-step.png" />
</Frame>
