A gallery is a primary media record that presents related images as one browsable item. It has its own identity and metadata; it is not merely the directory containing its image files.
| Field | Meaning |
| Title | Display title for the gallery. |
| Date | Calendar date associated with the gallery. |
| Code | Studio- or publisher-assigned catalog code. |
| Photographer | Free-text photographer value. |
| Details | Longer free-text description. |
| Organized | User-managed organization state. |
| Cover imagery | Front, back, or selected member imagery used to represent the gallery. |
| Created and Updated | Timestamps maintained by Cove for the record. |
| Relationship | Cardinality | Behavior |
| Studio | Zero or one | Primary studio associated with the gallery. |
| Tags | Zero or more | Reusable classification metadata. |
| Performers | Zero or more | Associated performer identities. |
| Images | Zero or more | Member images; membership does not store an image order. |
| Videos | Zero or more | Related video records displayed separately from member images. |
| Groups | Zero or more | Group memberships that include the gallery. |
| URLs | Zero or more | External links associated with the record. |
| Custom Fields | Zero or more | Administrator-defined gallery fields and values. |
| File value | Meaning |
| Folder path | Configured folder backing a folder-based gallery; it can be present without a directly attached gallery file. |
| Path | Cove-visible path for a file attached directly to the gallery. |
| File Size | Size in bytes, formatted for display. |
| Modified | Filesystem modification time discovered during scanning. |
| Fingerprints | Available hashes for the attached file. |
| Member image files | Belong to the related image records rather than to the gallery record. |
| Capability | Support | Behavior |
| Library list | Built in | Supports search, filters, sorts, display modes, selection actions, and extension contributions. |
| Image membership | Supported | Collects existing image records without transferring their identity or metadata. |
| Related videos | Supported | Associates videos with the gallery independently of image membership. |
| Chapters | Supported | Stores a title and image index as API metadata; the current core gallery UI does not surface chapters. |
| Engagement | Supported | Ratings and favorites are user-specific rather than shared descriptive fields. |
| Playback | Not applicable | The gallery is a collection record rather than one playable media source. |
| Surface or operation | Availability |
| Browsing and detail | Requires gallery-read access; content rules can further determine which records are visible. |
| Editing | Requires gallery-write access. |
| Editing a member image | Requires image-write access; gallery-write access does not grant authority over the image record. |
| Deletion | Requires gallery-delete access. |
| Images tab | Requires image-read access in addition to access to the gallery. |
| Videos tab | Requires video-read access in addition to access to the gallery. |
| File Info tab | Requires gallery-read access; unlike Video File Info, it does not add a file-read requirement. |
| Rescan | Requires library-scan access and an attached folder or file path. |
| Extension surfaces | Appear only when the contributing extension is installed and enabled and the operation is authorized. |
| Event or operation | Effect |
| Create without members | A gallery can exist before images or videos are associated with it. |
| Add or remove image membership | Changes the collection relationship without changing or deleting the image record or source file. |
| Add or remove a related video | Changes only the gallery relationship to that video. |
| Delete gallery | Removes the gallery and foreign-key-backed relationships such as image and video memberships without deleting those records. |
| Existing group items | Generic group-item references to a deleted gallery are not removed automatically. |
| Source-file deletion | Gallery deletion does not offer deletion of member image files, related video files, or directly attached gallery files. |
Some workflows discover images from a gallery-associated path, while others organize image records already in the library. The gallery remains the stable collection boundary in both cases. Chapters store a title and image index for API workflows, but the current core UI does not surface them and image membership itself does not store an order.