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

# Journeys

> Build one trip from transport orders, shipments, and an allocation.

## Overview

A journey is the full trip for one set of plant. It stores the name, the project, and the owner for that trip.

The journey holds every document for the trip, in order. You add the plant once. Idalia puts that plant on each stage.

A stage is one of these records:

* A [transport order](https://useidalia.com/docs/logistics/transport.md) for a road leg
* A [shipment](https://useidalia.com/docs/logistics/shipments.md) for an air or sea leg
* An [allocation](https://useidalia.com/docs/allocations/introduction.md) for the time the plant is on a project

Add the plant before you add the stages. Each new stage then includes that plant. If you add a stage first, add the plant after. Idalia copies it onto the stages that are already there.

A transport order, a shipment, or an allocation can sit on one journey only. Keep the return trip on the same journey.

For a local yard-to-site, see [Last-mile site delivery](https://useidalia.com/docs/guides/plan-a-last-mile-site-delivery.md). For a full trip from the yard and back, see [Mobilise and demobilise plant](https://useidalia.com/docs/guides/mobilise-and-demobilise-plant.md).

## View journeys

You can view and manage journeys from the [Journeys](https://idalia.app/journeys) page. Open a journey to see its overview.

The list shows each journey's number, name, stage count, project, and owner.

Open a journey to see its stages and its assets. The overview shows the name, the project, and the owner.

## Create a journey

A **name** is required. Project, owner, and notes are optional. The owner defaults to you. You can change it before you save.

You can create a journey from the Journeys page. Press <kbd>Create</kbd> (shortcut <kbd>C</kbd>).

Name the journey for the plant and the job. Set the project when the trip belongs to one job.

On save, Idalia opens the journey.

## Update a journey

When you view a journey, you can update its name, project, and owner on the overview.

Open **Menu** in the top right (shortcut <kbd>M</kbd>) to add a stage or add an asset.

On **Stages**, choose **Add stage**. Create the transport order, shipment, or allocation from the journey so it attaches to this journey. Drag a stage to change the order.

On **Assets**, add the plant that travels. Add the plant before the stages when you can.

## Delete a journey

Delete removes the journey and its stages. The transport orders, shipments, and allocations stay in the workspace.

1. Open the journey.
2. Open **Menu** (shortcut <kbd>M</kbd>).
3. Choose **Delete journey**.
4. Confirm in the dialog.

Idalia takes you back to the Journeys list.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.