SIGNALS Docs
Reader View

Catalogue item groups

Organise your catalogue into a hierarchy of groups and subgroups with images and custom fields.

Overview

Catalogue item groups are the organisational backbone of the Signals catalogue. They act as categories — grouping related catalogue items together for browsing, filtering, and reporting. Groups support a two-level parent/child hierarchy so you can structure your catalogue (e.g. "Lighting" with subgroups "Moving Heads" and "LED Bars"), attach an image for visual identification, and carry custom fields.

There is no separate group detail page: you manage a group from the list and its edit form.

Catalogue item groups list

Route: /catalogue-item-groups

Browse all catalogue item groups with search, sorting, and pagination.

  • View mode — switch between a Tree view (subgroups nested under their parent) and a Flat list
  • Search — filter by group name
  • Column sorting — click sortable column headers
  • Bulk delete — select rows and use Delete Selected
Column Description
Name Group name with optional image
Catalogue items Count of catalogue items assigned to this group; links to the filtered catalogue item list
Description Group description
Parent Group Parent group if this is a subgroup
Created Creation date

Row actions

Each row has a dropdown menu with View catalogue items, Edit, and Delete.

Create / edit catalogue item group

Route: /catalogue-item-groups/create or /catalogue-item-groups/{id}/edit

Field Description
Name Group name (required)
Parent group Optional parent group — making this a subgroup
Description Free-text description
Group image Optional image shown alongside the group name
Custom fields Custom fields for catalogue item groups, grouped by custom field group

When editing, a Hierarchy impact preview shows how many catalogue items and direct child groups the change of parent affects. If the group changes while you are editing, the preview goes out of date: use Refresh preview and review the move again before saving.

Parent/child hierarchy

Catalogue item groups support one level of nesting. A group with no parent is a root group; a group with a parent is a subgroup.

  • Root groups appear at the top level of the tree view.
  • Subgroups are nested under their parent.
  • A subgroup cannot itself be a parent, and a group cannot be moved beneath itself — the hierarchy is limited to two levels.
  • Catalogue items are assigned to a specific group (root or subgroup); they are not automatically rolled up to the parent.

When using the API, the parent_id field identifies the parent group. Use ?include=parent to get the parent's id and name inline, or ?include=children to get an array of immediate child groups.

Images

Each group can have an icon — a small image shown alongside the group name in the catalogue and catalogue item lists.

Images are uploaded in the Group image section of the create/edit form:

  • Supported formats: JPEG, PNG, WebP, GIF
  • The full-size image is stored alongside a 300×300 thumbnail
  • Removing the icon clears both

The resource inside response data contains the pair as a single icon object rather than two flat URL fields. For example:

{
  "data": {
    "icon": {
      "url": "https://example.test/storage/icons/catalogueitemgroups/7/2f1c….png",
      "thumb_url": "https://example.test/storage/icons/catalogueitemgroups/7/thumbs/2f1c….png"
    }
  }
}

icon is null when the group has no icon. thumb_url is null when the thumbnail has not been generated yet — display the full-size url in that case rather than treating the icon as missing. Regenerate 300×300 thumbnails from the full-size images with:

php artisan signals:regenerate-icon-thumbnails

New uploads are generated at 300×300 automatically. On a non-local disk both URLs are signed and expire, so resolve them per request instead of caching them.

Note

Icon uploads are managed through the UI form only; the REST API returns the icon object in the response but does not accept file uploads directly on the group endpoint. Use the attachments endpoint for file uploads.

Live filters

Saved list configurations allow customising the catalogue item groups list with specific columns, filters, and sort orders. The default system view is All Catalogue item groups.