> ## Documentation Index
> Fetch the complete documentation index at: https://pigeonholeapp.co.uk/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Updating Profile Images

> How to add and edit profile images for children, staff, and parents/carers.

# How to update profile images for Children, Staff and Parents/Carers

Pigeonhole allows you to store and edit profile images for children, staff members, and parents/carers. Profile images help you quickly identify individuals throughout the system and create a more personal experience.

## Overview

Profile images can be uploaded in two ways:

* **Uploading a file** from your local computer (JPG, PNG, GIF formats supported)
* **Importing from a URL** - paste a link to an image from an external system

<img src="https://mintcdn.com/pigeonholeearlyyearsltd/Zle3I897WaMJhxYe/images/update-image-popup.png?fit=max&auto=format&n=Zle3I897WaMJhxYe&q=85&s=08219ce92a25277b8839b48395b4126a" alt="Edit Profile Image" width="463" height="540" data-path="images/update-image-popup.png" />

Once uploaded, you can crop and resize the image to ensure it displays perfectly throughout the system.

## Updating from Profile Pages

Profile pages provide the most comprehensive image editing experience with larger preview sizes and full editing capabilities.

### Children Profile Pages

1. Navigate to [Children](/admin/children) and select a child
2. On the child's profile page, click on the profile image (or the placeholder if no image exists)

<img src="https://mintcdn.com/pigeonholeearlyyearsltd/Zle3I897WaMJhxYe/images/update-image-profile.png?fit=max&auto=format&n=Zle3I897WaMJhxYe&q=85&s=3aa3a3ad19a1de1fbb7414fc61eac3f2" alt="Edit Profile Image" width="571" height="365" data-path="images/update-image-profile.png" />

3. The image editor will open where you can:
   * Click "Upload Image" to select a file from your computer
   * Paste a URL in the "Import from URL" field
   * Use the cropping tool to adjust the image positioning and zoom
4. Click "Save" to apply your changes

### Staff Profile Pages

1. Navigate to [Staff](/admin/staff) and select a staff member
2. In the "Personal Details" section, click on the profile image
3. Follow the same upload and editing process as described above
4. The updated image will appear throughout the system wherever this staff member is displayed

### Parents/Carers (Relatives) Profile Pages

1. Navigate to [Relatives](/admin/relatives) and select a parent/carer
2. Click on their profile image in the profile section
3. Upload and edit the image using the same process
4. The image will be updated across all areas where this relative appears

## Updating from List Views

For quick updates, you can edit profile images directly from list views without navigating to individual profile pages.

### Children List View

1. Go to [Children](/admin/children)

<img src="https://mintcdn.com/pigeonholeearlyyearsltd/Zle3I897WaMJhxYe/images/update-image-list.png?fit=max&auto=format&n=Zle3I897WaMJhxYe&q=85&s=6f57e985acb0fa90a5c14529258018f9" alt="Edit Profile Image" width="1033" height="433" data-path="images/update-image-list.png" />

2. In the children list, simply click on any child's profile image (or avatar placeholder)
3. The image editor dialog will open, allowing you to upload and edit images
4. Changes are saved automatically and reflected immediately in the list

### Staff List View

1. Navigate to [Staff](/admin/staff)
2. Click on any staff member's profile image in the list
3. Edit the image using the popup editor
4. The updated image appears instantly in the staff list

### Relatives List View

1. Go to [Relatives](/admin/relatives)
2. Click on any relative's profile image
3. Make your changes in the image editor
4. The list updates automatically with the new image

## Image Editor Features

### Upload Options

* **File Upload**: Supports JPG, PNG, and GIF formats
* **Drag and Drop**: Simply drag image files into the upload area
* **URL Import**: Paste any publicly accessible image URL.  Simply right click on any image and click 'Copy Image Address'.  The right click in the image editor url text box and click 'Paste'

<img src="https://mintcdn.com/pigeonholeearlyyearsltd/Zle3I897WaMJhxYe/images/update-image.gif?s=53f7a3f8e669e522ef9adc5e6d756a27" alt="Edit Profile Image" width="866" height="478" data-path="images/update-image.gif" />

## Troubleshooting

**Image won't upload?**

* Check the file format (JPG, PNG, GIF only)
* Ensure the file size is under 5MB
* Try using a different browser if problems persist

**Image appears blurry?**

* Use a higher resolution source image
* Avoid over-zooming during the crop process
* Ensure the original image is clear and in focus
