# multi-axis

Configure a `multi-axis` gantry to integrate a gantry made up of multiple [`single-axis`](https://docs.viam.com/reference/components/gantry/single-axis/) gantries into your machine.

First, physically assemble the gantry and connect it to your machine’s computer.
Next, configure each single-axis gantry that is part of the multi-axis gantry.

- [JSON Template](https://docs.viam.com/reference/components/gantry/multi-axis/#tabset-referencecomponentsgantrymulti-axis-1-0)
- [JSON Example](https://docs.viam.com/reference/components/gantry/multi-axis/#tabset-referencecomponentsgantrymulti-axis-1-1)

The following attributes are available for `multi-axis` gantries:

| Attribute            | Type   | Required? | Description                                                                                               |
|----------------------|--------|-----------|-----------------------------------------------------------------------------------------------------------|
| `subaxes_list`      | array  | **Required**  | An array of the `name` of each of the sub-axes, the [`single-axis`](https://docs.viam.com/reference/components/gantry/single-axis/) gantries that make up the `multi-axis` gantry. |
| `move_simultaneously`| boolean| Optional  | A boolean indicating if the sub-axes should move together, or one at a time when `MoveToPosition` is called.<br>Default: `false` |

## Test the gantry

Once your gantry is configured and connected, open the gantry’s **TEST** panel on the **CONFIGURE** or [**CONTROL**](https://docs.viam.com/monitor/default-interface/#web-ui) tabs.

Use the panel to adjust the position of the actuator on the axis and check whether it moves as expected.

If the gantry does not appear on the **TEST** panel, or if you notice unexpected behavior, check your machine’s [**LOGS** tab](https://docs.viam.com/monitor/troubleshoot/#check-logs) for errors, and review the configuration.