Pet & Owner Registry – User Manual

Pet & Owner Registry

A complete guide to registering, managing, and searching pet and owner records in your clinic. All records are shared with Case Management — no duplicate entry ever needed.

🐕 Multi-species 📱 Phone-based lookup 🔒 Identity field locking ⬇️ Excel export 🔧 Custom fields
📋

What is the Pet Registry?

The Pet Registry is the centralised database of all pets and their owners in your clinic. Every pet registered here is saved into the same shared table that Case Management reads — meaning the moment you type a mobile number in any case form, the system instantly recognises the owner and their pets. There is zero duplication of data entry between the two systems.

Think of the Pet Registry as the master contact book for your clinic: you register a pet once, and it becomes available everywhere — in cases, in the Vaccination Tracker, and in the All Pets view.

📋

Centralised Records

One pet record shared across all features — cases, vaccinations, and the all-pets view.

📱

Phone-Based Lookup

Type a mobile number and instantly see all pets registered under it, with owner details auto-filled.

🆔

Auto Pet ID

A unique Pet ID is generated automatically from the phone number and pet name. No manual ID entry.

⬇️

Excel Export

Export all or filtered records to a formatted Excel spreadsheet in one click.

👥

Who Can Access the Pet Registry

Four roles have access to the Pet Registry page. What each role can do varies slightly.

Clinic Director

Full access. Can add, view, edit, delete all pet records, and export to Excel.

Veterinarian

Can add, view, and edit pet records, and export to Excel. Can also delete records.

Para Vet

Can add, view, and edit pet records. Cannot delete records. Cannot export to Excel.

Receptionist

Can add, view, and edit pet records. Cannot delete records. Cannot export to Excel.

ℹ️

If you cannot see the Pet Registry page, your account may not have a Director assigned. Contact your clinic director or administrator to resolve this.

ActionDirectorVeterinarianPara VetReceptionist
View all pets
Add a new pet
Edit a pet record
Delete a pet record
Export to Excel
🏠

Page Layout

When you open the Pet Registry page, you see the following sections:

AreaWhat it does
🐾 Pet Registry title + countShows the total number of pets currently registered in your clinic (updates with filters applied)
+ Add Pet button (top right)Opens the Add New Pet form popup
⬇ Export Excel button (top right)Exports the current filtered list to an Excel file. Only visible to Directors and Veterinarians.
Search barLive text search across all pet and owner fields
Filter icon buttonOpens the filter popup panel for Species, Sex, and date range filters
✕ Clear buttonRemoves all active search and filter values at once. Only appears when a filter is active.
Pet card gridShows 12 pet records per page in a card layout
Pagination barNavigate between pages. Shows current page and total pages. Only appears when records exceed 12.
🎛️

Filters

Click the filter icon button in the controls bar to open the filter popup panel. You can combine multiple filters at the same time — they are applied on top of any text in the search bar.

FilterOptionsHow it works
SpeciesDynamically populated from species in your clinicShows only pets of the selected species
SexMale / FemaleShows only male or only female pets
Date FromDate pickerShows only pets registered on or after this date
Date ToDate pickerShows only pets registered on or before this date

When any filter is active, the filter icon button gets a highlighted dot to indicate active filters. The ✕ Clear button also appears — click it to remove the search text and all filters at once.

ℹ️

The Species filter dropdown is populated dynamically from the actual species present in your clinic's records — it shows only species that exist in your data.

🃏

Pet Cards

Each registered pet appears as a card in the grid. The card shows a quick summary of the record.

Card ElementWhat it shows
Pet photo / species iconIf a photo was uploaded, it displays here. If no photo, a species emoji icon is shown instead (🐕 🐈 🐰 🐦 🐢 🐾)
Pet NameThe registered name of the pet
Has Cases badgeAppears on every card to indicate this pet has linked case records
Pet IDThe auto-generated unique identifier shown below the pet name
Species / Breede.g. Dog – Labrador Retriever
OwnerOwner's full name
MobileOwner's phone number
✏ Edit buttonOpens the edit form for this pet. Visible to all roles.
🗑 buttonDeletes this pet record. Only visible to Directors and Veterinarians.
💡

Clicking anywhere on the card body (not on the buttons) opens the full View Details popup for that pet.

📄

Pagination

The registry shows 12 pet records per page. When there are more than 12 records, a pagination bar appears below the card grid.

ControlWhat it does
PreviousGo to the previous page (disabled on page 1)
Page number buttonsJump directly to any page. The current page is highlighted. Pages far from the current page show ellipsis.
NextGo to the next page (disabled on the last page)
Page X of YShows current page position and total pages

When you click a page number, the page scrolls automatically back up to the grid so you don't have to scroll manually.

Add New Pet

Click the + Add Pet button in the top right to open the Add New Pet form popup. The form is divided into two sections — Owner Details and Pet Details.

1

Click "+ Add Pet" on the registry page

A popup form opens with two sections — Owner Details and Pet Details.

2

Enter the owner's mobile number first

The system checks instantly for existing records under that number. If found, owner fields auto-fill and all pets already registered to that number are shown in a list below the phone field.

3

Fill in all required Owner fields

Owner Name and Mobile Number are required. Email and Address are optional.

4

Fill in all required Pet fields

Pet Name, Species, Breed, and Sex are required. All other pet fields are optional.

5

Optionally upload a pet photo and fill custom fields

Click "📷 Choose Photo" to upload an image. Custom fields (if any are configured for your clinic) appear at the bottom of each section.

6

Click "Save Pet"

A unique Pet ID is auto-generated and the record is saved. The card grid refreshes immediately to show the new pet.

📱

Phone Number Lookup

When you type a mobile number in the Mobile Number field of the Add Pet form, the system automatically searches for existing records under that number after a short delay (the field needs at least 5 characters to trigger the check).

If the owner is already registered

When a match is found, three things happen automatically:

1

Owner fields auto-fill

Owner Name, Email, and Address fill in automatically from the existing record. Fields that already have values typed in them are not overwritten.

2

Owner custom fields auto-fill

Any custom field values stored for the owner also populate automatically.

3

Existing pets list appears below the phone field

A list of all pets already registered under this number is shown — including each pet's name, species, breed, and Pet ID.

What you see when a phone number is recognised
📱✓ Owner found
🐾 2 pet(s) registered with this number:
  • Bruno — Dog (Labrador) 9876543210bru
  • Buddy — Dog (Beagle) 9876543210bud

If the phone number is new

A "New owner" label appears in grey below the field. No fields are auto-filled. You proceed to fill in all owner and pet details manually.

💡

This lookup is the key to avoiding duplicate owner entries. Always enter the mobile number first — if the owner is already in the system, you save time and maintain data consistency.

👤

Owner Fields

The Owner Details section captures information about the pet's owner.

FieldRequired?Notes
Owner NameRequiredFull name of the person who owns the pet
Mobile NumberRequiredUsed for the phone lookup feature and links this pet to the owner across all cases
EmailOptionalOwner's email address
AddressOptionalOwner's physical address — full-width textarea
ℹ️

The mobile number is the key that links an owner to all their pets across the entire system. Two pets with the same phone number belong to the same owner.

🐾

Pet Fields

The Pet Details section captures all clinical and identification details about the animal.

FieldRequired?Notes
Pet NameRequiredThe pet's registered name. Locked after saving and cannot be changed by editing.
SpeciesRequiredDog, Cat, Rabbit, Bird, Turtle, Tortoise, or Other (custom). Locked after saving.
BreedRequiredThe pet's breed. Locked after saving.
SexRequiredMale or Female. Locked after saving.
Birth DateOptionalSetting this auto-calculates the Age field
AgeOptionalRead-only when Birth Date is set — auto-calculated. Can be typed manually if no Birth Date is set.
WeightOptionale.g. 15 kg
MarkingOptionalPhysical markings to identify the pet, e.g. "white spot on left ear"
Chip NoOptionalMicrochip ID number
NeuteredOptionalYes / No
RabiesOptionalYes / No — indicates if the pet has had rabies vaccination
Pet PhotoOptionalUpload a JPG, PNG, WEBP, or GIF image. Maximum file size: 5 MB.
🔠

Species & Custom Species

The Species field is a dropdown with predefined options. If your pet does not fit into any standard option, you can enter a completely custom species name.

Predefined species options

Dog, Cat, Rabbit, Bird, Turtle, Tortoise — these are always available in the Species dropdown.

Entering a custom species

1

Select "Other …" in the Species dropdown

A new text input labelled "Custom Species" appears directly below the Species dropdown.

2

Type the custom species name

e.g. Hamster, Guinea Pig, Chinchilla. This value is saved as the species for this pet record.

ℹ️

Custom species you add appear in the Species filter dropdown on the registry page once they are saved, making it easy to filter by them in future.

🗓️

Age Auto-Calculation

The Age field is connected to the Birth Date field. When you set a Birth Date, the Age field is automatically calculated and filled in — you do not need to enter it manually.

How the age is calculated

The system calculates age from the birth date to today and formats it automatically:

AgeFormat shown
Less than 1 month olde.g. 12 days
1 month to 11 months olde.g. 7 months
1 year or oldere.g. 2 years 4 months
ℹ️

When a Birth Date is set, the Age field becomes read-only — it is filled automatically and you cannot manually type in it. If no Birth Date is set, you can type any age value directly in the Age field.

📷

Pet Photo Upload

You can attach a photo to any pet record. The photo shows on the pet card in the grid and inside the view popup.

1

Click "📷 Choose Photo" in the Pet Details section

A file browser opens on your device.

2

Select an image file

Accepted formats: JPG, JPEG, PNG, WEBP, GIF. Maximum file size: 5 MB.

3

The image uploads and a preview appears

A thumbnail preview shows below the upload button. An "✕ Remove" button also appears next to it.

4

To remove the photo, click "✕ Remove"

The preview clears and no photo will be saved with the record.

⚠️

Files larger than 5 MB are rejected. If an upload fails due to file type, the system shows an error message. Only JPG, JPEG, PNG, WEBP, and GIF files are accepted.

🔧

Custom Fields

Both the Owner section and the Pet section of the form support Custom Fields. These are extra fields defined by your clinic to capture any additional information not covered by the default fields. They appear automatically at the bottom of each section when custom fields are configured.

How custom fields appear

Custom fields are loaded automatically when the form opens. They appear below the standard fields in each section. Custom fields can be of three types:

Field TypeBehaviour
TextA plain text input — type any value
NumberA number input — accepts numeric values only
DropdownA select dropdown with pre-defined options set by the clinic

How custom field values are saved

Custom field values are saved automatically after the main pet record is saved. They are linked to the individual pet's record and are specific to your clinic — they are not shared with other clinics.

Custom fields on phone lookup

When an existing owner is found via phone lookup, the owner-section custom field values are also auto-filled from the stored record, just like the standard owner fields.

ℹ️

If you do not see any custom fields in the form, it means your clinic has not configured any. Custom field definitions are managed separately and are not set up from within the Pet Registry itself.

👁️

View Pet Details

To see the full details of any pet, click anywhere on its card (not on the Edit or Delete buttons). This opens a View Details popup with all stored information displayed in a read-only layout.

What the View popup shows

SectionFields displayed
Pet Name & IDPet name, Pet ID, and a "Has linked cases" badge
Owner DetailsName, Mobile, Email, Address, plus any owner custom fields
Pet DetailsPhoto (if uploaded), Species, Breed, Sex, Birth Date, Age, Weight, Marking, Chip No, Neutered, Rabies, plus any pet custom fields

Actions inside the View popup

ButtonWhat it doesWho sees it
✏ EditCloses the view popup and opens the Edit form for this petAll roles
🗑 DeleteOpens a confirmation prompt and permanently deletes the recordDirector & Veterinarian only
✏️

Edit a Record

To edit a pet record, click the ✏ Edit button on the pet card or inside the View popup. The same form opens with all existing values pre-filled, ready for you to update.

Editable fields

In edit mode, the following fields can be updated freely:

Owner Name, Mobile Number, Email, Address, Birth Date, Weight, Marking, Chip No, Neutered status, Rabies status, Pet Photo, and all custom fields.

Locked fields in edit mode

Four fields are permanently locked once a pet record has been saved. They show as greyed-out with a lock banner at the top of the Pet Details section:

Locked FieldWhy it is locked
Pet Name LockedPet Name forms part of the Pet ID — changing it would break the ID link
Species LockedSpecies is a core identity field tied to historical records
Breed LockedBreed is a core identity field tied to historical records
Sex LockedSex is a core identity field tied to historical records
⚠️

These fields are locked for all users including Directors. This is intentional — changing identity fields would affect the accuracy of historical records and break the Pet ID. If a genuine correction is needed, contact your system administrator.

🔒

Locked Fields Explained

Pet Name, Species, Breed, and Sex are locked immediately after a pet record is first saved. This locking applies in the Pet Registry, in Case Management, and everywhere else these fields appear in the system.

The lock exists to preserve data integrity — once a pet has records in the system, changing its name, species, or breed would create inconsistencies in historical case data. The Pet ID is also built from the pet's name, so changing the name after saving would break the ID.

💡

If you accidentally entered a wrong Pet Name or Species when creating a record and need it corrected, contact your clinic director or administrator.

🗑️

Delete a Record

Only Clinic Directors and Veterinarians can delete pet records. Para Vets and Receptionists do not see the delete button.

1

Click the 🗑 button on the card or in the View popup

A confirmation dialog appears — "Delete this pet record? This cannot be undone."

2

Click OK to confirm

The record is permanently removed. The grid refreshes immediately. This action cannot be reversed.

⚠️

Deletion is permanent and cannot be undone. Be certain before confirming. Deleting a pet from the Registry removes the base record — any existing cases linked to that pet will remain in Case Management but the owner and pet information will no longer be linked.

🆔

Pet ID

Every pet saved in the registry gets a unique Pet ID generated automatically. You never enter this manually — the system creates it when the record is saved for the first time.

How the Pet ID is built

The Pet ID is a combination of the digits-only phone number and the first 3 characters of the pet name (lowercased):

Phone: 9876543210  +  Pet Name: Bruno
→ Pet ID: 9876543210bru

Same owner, second pet "Buddy" → 9876543210bud
If two pets share the same first 3 letters: 9876543210bru & 9876543210bru2

Collision handling

If two pets of the same owner share the same first 3 letters in their name, the system automatically appends an incrementing number to make the ID unique: brubru2bru3 and so on.

💡

The Pet ID is the fastest way to pull up a specific pet in Case Management. Paste it into the "Link to Existing Case" field and click Fetch Details to auto-fill all owner and pet information instantly.

⬇️

Export to Excel

The ⬇ Export Excel button exports the current list of pets to a formatted .xlsx Excel spreadsheet. This button is only visible to Clinic Directors and Veterinarians.

What gets exported

The export uses whatever filters are currently active — the same pets shown on screen are what get exported (all pages, not just the current page). If you have a Species filter set to "Dog", the export contains only dogs.

Columns in the exported file

The Excel file contains the following columns in this order:

Pet ID
Pet Name
Species
Breed
Sex
Birth Date
Age
Weight
Neutered
Rabies Vaccinated
[Pet custom fields]
Marking
Chip No
Owner Name
Owner Mobile
Owner Email
Owner Address
[Owner custom fields]
Registered On

Custom fields (if configured for your clinic) appear as additional columns in the export, placed after the standard fields in their respective section (pet or owner).

Excel file details

PropertyDetail
FilenamePet_Registry_YYYY-MM-DD.xlsx — dated with today's date
Sheet namePet Registry
Header rowFrozen (stays visible when scrolling down)
Column widthsAuto-sized to fit content, capped at 40 characters wide
Neutered / Rabies valuesDisplayed as "Yes" or "No" in the export
ℹ️

The button shows "⏳ Exporting …" while processing. If no records match the current filters, an error message is shown and no file is downloaded.

Frequently Asked Questions

Why don't I see the Pet Registry page?

You need to be logged in as a Clinic Director, Veterinarian, Para Vet, or Receptionist. If you are logged in and still can't see the page, your account may not have a Director assigned. You will see an "Access denied" or "No director assigned" message. Contact your clinic director or administrator.

I can't see the Delete button on the cards. Why?

The delete button is only visible to Clinic Directors and Veterinarians. Para Vets and Receptionists cannot delete records. If you are a Director or Vet and still don't see it, check that you are logged in with the correct account.

I can't see the Export Excel button. Why?

The Export Excel button is only shown to Clinic Directors and Veterinarians. Para Vets and Receptionists do not have access to export.

Pet Name, Species, Breed, and Sex are greyed out when I try to edit. Why?

These four fields are permanently locked in edit mode for all users. This is by design — they are identity fields that form the basis of the Pet ID and link to historical case records. Changing them after the record is saved would break data integrity. If you made a genuine error, contact your clinic director or administrator.

How is the Pet ID generated? Can I set my own?

The Pet ID is automatically generated from the owner's phone number (digits only) plus the first 3 characters of the pet name in lowercase. For example, phone 9876543210 and pet name "Bruno" gives Pet ID 9876543210bru. You cannot set a custom Pet ID — it is always auto-generated by the system when the record is first saved.

I typed a mobile number but the phone lookup didn't auto-fill anything. Why?

The lookup triggers after at least 5 characters are entered in the Mobile Number field. If you typed fewer than 5 digits it won't activate. If you typed 5+ digits and still nothing appeared, this phone number is not yet registered — the owner and their pets are new to your clinic.

Can I add more than one pet for the same owner?

Yes. Each pet is a separate record. Use the same phone number for all pets belonging to the same owner. The phone lookup will recognise the owner and auto-fill their details, and it will also show a list of all pets already registered under that number.

What happens if I upload a photo that is too large?

If the file exceeds 5 MB, an error message appears immediately after selection and the upload is blocked. Reduce the file size or choose a different image and try again. Only JPG, JPEG, PNG, WEBP, and GIF files are accepted.

Does the export include all pages or only what is on screen?

The export includes all records matching the current filters — not just the current page. If you have 200 pets and no filters active, all 200 are exported to the Excel file even though only 12 are shown on screen at a time.

I can't find a pet using the search bar. What should I try?

The search bar covers owner name, mobile number, email, address, pet name, Pet ID, species, breed, chip number, and marking. Try searching by mobile number — it is usually the most unique identifier. Also check whether any filters are active (look for the highlighted dot on the filter button) — filters may be narrowing the results. Click ✕ Clear to remove all active search text and filters.

I don't see any custom fields in the form. Is something wrong?

No — it means your clinic has not configured any custom fields yet. Custom fields are optional and are set up separately. If your clinic needs additional fields on pet or owner records, ask your clinic director to configure them.