Skip to main content
Custom attributes are extra fields you define yourself to record information about children that isn’t covered by Pigeonhole’s standard fields. Once set up, they appear on every child’s profile and can be used to filter your children list. This page covers setting your attributes up during onboarding. For how staff and admins then fill them in and filter by them, see Creating and Using Custom Attributes.

What Custom Attributes Are For

Custom attributes let you tailor Pigeonhole to your setting. Common examples include dietary requirements, permissions granted by parents, learning goals, medical notes, or transport arrangements. Attributes are organised into groups. A group is a heading that keeps related attributes together on the child profile and register — for example, a “Permissions” group containing several yes/no permission attributes.
The Custom Attributes settings page showing an attribute group with several attributes inside it

Field Types

Each attribute has a type that controls how staff enter its value:
  • Free Text - Any text, best for open-ended notes like special instructions.
  • Yes/No - A simple on/off value, best for permissions or flags.
  • List of Values - A dropdown of options you define, best for consistent choices like dietary requirements (e.g. Vegetarian, Vegan, Gluten-free).

Step 1: Add a Group

  1. On the Custom Attributes page, click Add Group.
  2. Enter a name for the group in the group name field (e.g. “Permissions”).
If you have no groups yet, click Add Group from the empty state to create your first one.

Step 2: Add Attributes to the Group

  1. Inside the group, click Add Attribute.
  2. Enter a descriptive name for the attribute (e.g. “Dietary Requirements”).
  3. Choose the type: Free Text, Yes/No, or List of Values.
  4. If you chose List of Values, add each option in the List Items section. Use the + button to add more options; you need at least two.
  5. Set the toggles for the attribute:
    • Show On Register - Displays this attribute when staff open a child from the register.
    • Filterable - Lets you filter the children list by this attribute. Available for Yes/No and List of Values types only.
Use the up and down arrows next to an attribute to change the order it appears in.
Adding an attribute to a group, showing the name field, type dropdown, and the Show On Register and Filterable toggles

Step 3: Save

Click Save Attributes to store your changes. Your attributes are now live.
Deleting an attribute removes it from every child who has it set, and this cannot be undone. You are asked to confirm before an attribute is deleted.

What Happens Next

  • Your attributes appear on every child’s profile, where admins can fill in values from the child edit page.
  • Attributes marked Filterable appear as filters on the children list view.
  • Attributes marked Show On Register appear when staff open a child from the register.
For a full guide to entering values on children and filtering by them, see Creating and Using Custom Attributes.