# Staff Signatures ## Overview Staff members can have a digital signature image stored in the system. This signature appears on printed documents — typically lab reports, prescriptions, discharge summaries, and official letters — where the clinician's authorisation needs to be represented visually. ## When to Use - A new doctor joins and their signature needs to be added for report printing - A staff member's signature image needs to be updated or replaced - An existing signature is incorrect and must be removed ## Navigating to Signature Management 1. Click **Administration** → **Manage Staff** 2. In the left index, click **Add Signature for Staff** (under the Staff section) 3. The **Add Staff Signature** screen opens To view existing signatures: 1. Click **View Staff Signatures** from the same index > **Required privilege:** AdminStaff ## Uploading a New Signature 1. In the **Add New Signature** panel (left side): - Search for the staff member in the **Name** autocomplete field - Click **Choose File** and select the signature image (PNG, JPG, or similar format) 2. Click **Save** 3. The current signature for that staff member appears in the **Current Signature** panel on the right ## Replacing a Signature To replace an existing signature, simply upload a new image for the same staff member. The new image will overwrite the previous one. ## Removing a Signature In the **Current Signature** panel on the right: 1. Select the staff member to see their current signature 2. Click **Remove** (red button with trash icon) ## Signature Format Recommendations - Use a white or transparent background image - PNG format gives the clearest result for signatures - Keep the image to a reasonable size — very large files slow down printing - Ensure the signature is legible at the size it will appear on printed documents ## How Signatures Appear on Documents Once uploaded, the signature image is embedded in printed outputs (lab reports, etc.) in the section designated for the clinician's authorisation. The exact placement depends on the report template configuration. ## Technical Notes (Admin/Developer) Signature images are stored and served by `StaffImageController`. The `uploadSignature()` method processes the file upload; `removeSignature()` deletes the stored image. The signature is retrieved in print composites via `staffImageController.signatureFromStaffController` as a `StreamedContent`. There is a companion page in `admin/institutions/` (`admin_staff_signature.xhtml` and `admin_staff_signature_url.xhtml`) for URL-based signature configuration. ## Related Features - [Staff Management Overview](Admin-Staff-Management-Overview) - [Creating and Managing Doctors and Consultants](Admin-Doctors-and-Consultants)