---
# Generated by the help-docs job in equiapp (ci/help-docs-generator) from the
# help anchor 'HorsesList'. Set generated to false to edit this page by hand; the job
# then leaves it alone.
helpKey: HorsesList
title: Horses
summary: >-
  View and manage your horses – search, filter, export, edit or move them. Only
  active horses load initially; a filter or search loads the full list.
generated: true
modals:
  bulk-edit:
    title: Bulk edit horses
    summary: >-
      Apply a single change to all selected horses at once by ticking a field
      and setting its new value; only the fields you enable will be updated.
  create-horse:
    title: Add horse
    summary: >-
      Add a new horse or reactivate an existing one – tick **Is external** if
      the horse isn’t in your stable; this hides the Stable, Location and Usage
      fields.
---

# Horses

The Horses page shows all horses belonging to your organisation. Use it to find a horse, filter the list, export the data, or change the location of one or more horses.

## What's on this page
- **Add horse** button (visible if you have the manage horses permission) opens the form to create a new horse.
- **Export** button (desktop only) downloads the current list as an Excel file.
- **Stable** filter (list) lets you limit the list to a specific stable, a sub‑location, or **Other** for an external location.
- **Filter** button opens a panel where you can filter by group, category, gender, age, temporary away and other criteria.
- **Search by Name, UELN, etc...** field instantly narrows the list as you type.
- **Select** button (small screens) starts selection mode so you can pick multiple horses.
- **Change** button (appears after you select horses) opens the bulk‑edit modal to update the selected horses.
- **Move** button (appears after you select horses) opens a list with destinations (other stable, pasture or external location) and starts the move procedure.
- **Horses** list displays **Name**, **Gender**, **Age**, and **Stable** (or **Location** for external horses). Above it a count like “currently showing X horses” tells how many horses are displayed.

## Common tasks
### Find a horse by name, UELN or chip number
1. Type the name, UELN or chip number into the **Search by Name, UELN, etc...** field.
2. The list updates instantly.

### Filter horses by stable, gender, age, group or other criteria
1. Tap the **Stable** filter and choose a stable, sub‑location, or **Other**.
2. (Optional) Tap **Filter**, tick the criteria you need, then close the panel.
3. The list now shows only the matching horses.

### Edit or move several horses at once
1. Hover a horse picture (desktop) or tap **Select** (mobile) and tick the horses you want.
2. Tap **Change** to open the bulk‑edit form, tick the fields to change, then press **Apply to X horses**.
3. Or tap **Move** to open the destination list, pick a new location and confirm.

## Good to know
- Only active horses with a stable are loaded initially; applying any filter or using the search loads all horses, including inactive and external ones.
- Selection mode starts when you hover a horse picture (desktop) or tap **Select** (mobile) and ends automatically when no horse remains selected.
- **Export** button is only visible on larger screens; on a phone you need a computer to download the Excel file.
- The **Move** list lets you move selected horses to another stable, a pasture or an external location; you can move several horses at once.
- The **Change** bulk‑edit form only updates the fields you tick; untouched fields stay unchanged.
- RVO actions (reporting arrivals or changing status) are shown only if you have the required rights.

**Change** button opens the **Update X horses** bulk‑edit modal. **Add horse** button opens the **Add horse** modal.

<!-- help-docs: modal bulk-edit -->

## Bulk edit horses {#bulk-edit}

Use this dialog to apply the same change to all selected horses at once.

### Group
- Tick the checkbox, then choose a group (or **None**) to set for every horse; untouched leaves current group.

### Vaccination rule
- Tick, then pick a vaccination rule (or **None**) for all horses; leaving it unchecked leaves each horse’s existing rule.

### Gender
- Tick, then select **Male**, **Female**, **Unknown** (or **None** to clear) for all horses.

### Usage
- Tick **Usage**, then check any of **Use for Sport**, **Use for Breeding**, **Use for Care**; unchecked flags are cleared.

### Team
- Tick **Team**, then assign a contact (or **None**) to **Default rider**, **Default groom**, **Default farrier**, **Default vet**, **Default trainer**, or click **Create new contact**; **None** clears the role.

### After saving
- The updates appear in the horse list; if any horse fails, an error is shown in the dialog.

<!-- help-docs: modal create-horse -->

## Add horse {#create-horse}

Use this dialog to add a new horse or reactivate an inactive one.

### Is external
- Tick to indicate the horse isn’t kept in any of your stables; **Stable**, **Location**, and **Usage** fields disappear.

### Horse location differs from stable
- Check when the horse’s spot isn’t the stable’s address; a **Location** field appears.

### Is imported
- Appears when the chosen destination isn’t a known contact; tick to flag the arrival as an import.

### Stable
- Choose the stable for the horse; hidden and auto‑filled if only one stable exists.

### Usage
- Choose applicable services (Care, Sport, Breeding). Shown only if those services are enabled.

### Existing Horse
- When a matching inactive horse is found a card appears; press **Use** to reactivate it or **View** for details.

### After saving
- The horse is added or re‑activated, shows in the list and you may be prompted to report the move to RVO.