> For the complete documentation index, see [llms.txt](https://docs.motorica.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.motorica.com/documentation/motion-factory/how-to-guides/trail-set-manager-guides/create-and-edit-gaits-trails-and-trail-segments.md).

# Create and Edit Gaits, Trails, and Trail Segments

In this guide, we'll demonstrate how to:

1. Create and edit Trail Sets from scratch.
2. Use custom Gaits.
3. Create Trails and perform batch Trail edits.
4. Create and customize a Trail's Segments.

{% hint style="info" %}
All customization options for Gaits, Trails, and Trail Segments can be performed for preset trails created using the Guided Template.
{% endhint %}

## Prerequisites

* A Motorica account, created when you first open the [Motorica app](https://app.beta.motorica.ai/).
* An enterprise license. For more information, contact our Sales team.

## Get Started

Open the Trail Set Manager module within your Motorica dashboard to begin.

## Create an Empty Trail Set

In the Trail Set Manager's dashboard, click the purple `New trail set` button and select the `Empty slate` template.

## Create a Custom Gait

A Trail Set must include at least 1 Gait to create Trails.

1. In the bottom left of the UI, click the `Click to add gait` button.
2. Name your new Gait and assign the gait a `m/s` speed value and a color swatch.
3. Click the purple `Create` button when you're finished.

<figure><img src="/files/wItOUR0d8yj0HGzntiSU" alt="A dark and purple UI on how to create a new Gait with text and number fields."><figcaption><p>Example of creating a new Gait called "Example_walk."</p></figcaption></figure>

## Create New Trails

1. Click the purple `+` dropdown on the left side of the UI.
2. Click the `Add Trail` option in the dropdown.
3. Assign your new Trail a name in the Trail file explorer.

{% hint style="info" %}
We recommend organizing your Trails in folders for a cleaner animation output from Motion Factory.
{% endhint %}

### Import Trails in JSON

1. Click the purple `+` dropdown on the left side of the UI, or right click in the Trail file explorer for a specific location.
2. Click the `Import` option in the dropdown. The file must be a `.fbx` file, or a `.json` file written in the [Pure Root Motion](/documentation/motion-factory/reference/pure-root-motion-format.md) format.
3. Assign your new Trail a name in the Trail file explorer.

## Customize a Trail

First, select a Trail you'd like to edit on the left side of the UI.

<figure><img src="/files/MbOUi82XaocssSozWL2W" alt="A file explorer containing different animation categories."><figcaption><p>Trail Files in the Trail Set Manager module.</p></figcaption></figure>

Then, adjust the Trail's parameters and the Trail's individual Segments on the right side of the UI.

<figure><img src="/files/UoPgOomSONwcTjUryjRA" alt="A dark and purple UI with adjustable values and dropdowns for editing a Trail and its associated Segments."><figcaption><p>Example of a Trail's selected Segment and the editing options available. </p></figcaption></figure>

For more information on the type of edits available, view the [Trail Set Manger Reference](https://docs.motorica.com/documentation/motion-factory/how-to-guides/trail-set-manager-guides/pages/Zl0Voz2B5OYUVkaXbQWQ#id-5.-trail-editor) doc.

{% hint style="info" %}
You can also select segments directly in the 3D viewport and below the Playback Timeline.
{% endhint %}

### Add a New Segment to a Trail

There are two ways to add a new Segment to a Trail: through the Trail Segments section, or through the 3D Viewport.

#### Option #1: Trail Segments section&#x20;

The Add Segment button in the Trail Segments section creates a new Segment from scratch. Segments created this way will have entirely default values and will not automatically match the previous Segment's Gait and chosen parameters.

<figure><img src="/files/4DPqMfvgPhN85nMHfd1d" alt="UI of Segments and buttons for adding and editing Segments."><figcaption><p>The Add segment button in the Trail Segments section.</p></figcaption></figure>

#### Option #2: 3D Viewport

The 3D viewport allows you to attach new segments onto existing ones and decide the direction of the newer segment in the 3D space. Segments created this way will match the Gaits and chosen parameters from their previous segments.

<figure><img src="/files/Prb4jFg92l0Iy22FObpr" alt="A grid space from a birds-eye view with a T-posing, grey meshed avatar standing on a red circular trail."><figcaption><p>Example of where to click in the 3D viewport to add new segments.</p></figcaption></figure>

### Edit Multiple Trails

First, select a Trail folder on the left side of the UI.&#x20;

Then, make batch edits to all Trails within the folder on the right side of the UI.

<figure><img src="/files/GLgwd6HFnDRuxtMJovuj" alt="Batch Edit controls and toggleable buttons for a selected Trail folder."><figcaption><p>Example of the Batch Edit section for a breakouts folder of 8 trails.</p></figcaption></figure>

For more information on the type of edits available, view the [Trail Set Manger Reference](https://docs.motorica.com/documentation/motion-factory/how-to-guides/trail-set-manager-guides/pages/Zl0Voz2B5OYUVkaXbQWQ#id-5.-trail-editor) doc.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.motorica.com/documentation/motion-factory/how-to-guides/trail-set-manager-guides/create-and-edit-gaits-trails-and-trail-segments.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
