---
title: Adding and editing pieces
description: Every field you can record for a piece of music, grouped by identity, musical details, liturgical use, and inventory.
---

From **Library**, use **Add piece** to create a new piece, or open an existing piece and choose **Edit** to change it. The only required field is **Title** — everything else is optional, so you can add a piece with just a title and fill in details later.

## Identity

| Field | Notes |
| --- | --- |
| Title | Required. |
| Subtitle | |
| Composer | |
| Arranger | |
| Lyricist | |
| Publisher | |
| Catalog number | Publisher plate/catalog number. |
| Genre | Free text — suggestions include Anthem, Hymn, Introit, Offertory, Response, Cantata, Solo, Instrumental, Service Music, but you can enter anything. |

## Musical details

| Field | Notes |
| --- | --- |
| Voicing | e.g. "SATB", "SAB", "Unison". |
| Instrumentation | |
| Key | e.g. "D major". |
| Duration | In seconds. |
| Difficulty | One of Beginner, Easy, Medium, Advanced, Difficult. |
| Language | |

## Liturgical use

| Field | Notes |
| --- | --- |
| Liturgical season | |
| Scripture references | Enter multiple references separated by commas. |
| Occasion | |
| Hymn tune name | |
| Lyric text | Free text — the full lyric, if you want it searchable and on hand. |
| Program notes | |

## Inventory

| Field | Notes |
| --- | --- |
| Quantity owned | Defaults to 1. |
| Storage location | Where physical copies live. |
| Purchase date | |
| Purchase price | |
| Purchase source | |
| Copyright status | |

## Other

| Field | Notes |
| --- | --- |
| External link | Must be a full `http://` or `https://` URL — for example a publisher page or a recording. |
| Notes | |

## Deleting a piece

Open the piece and use **Delete** on its detail page. Deleting a piece also removes it from any [collections](/docs/library/collections) it belongs to and from any services or performances that reference it directly (items that only reference it by a custom title are unaffected).

:::note
Deleting a piece that is a [multi-movement work](/docs/library/multi-movement-works) deletes its movements too.
:::