Skip to main content

Animal Icons

Kathryn H.
Kathryn H.
  • Updated

Overview: What are we talking about?

Custom animal icons are an easy way to see important details about a pet wherever you see their name in Gingr, as well as wherever the icons are configured to display in pop-up alerts. Gingr offers system icons, which are added to an animal automatically under certain conditions such as expired immunizations, unsigned agreements, or the animals' birthday. Additionally, you can set up custom icons, which can be configured to identify anything you can imagine such as Playgroup assignments, Medical conditions, Behavioral issues, Special Discounts, and more!


This article includes:


Helpful Hints: Before you begin.

  • Animal Icons are never visible to your customers, so feel free to be creative with them!

  • All admin users have access to the admin page controlling these settings. Additionally, admin users are able to delegate this particular admin page to other user groups. Non-admin users with access to this page will be able to make certain edits to this page. For more information see our article on User Groups and Permissions


Set It Up: Let's get started. 

System Animal Icons 

Gingr offers several system icons, which will be automatically assigned to animals based on certain conditions. Each system icon listed below can be enabled or disabled depending on your preferences, and can be configured to display in pop-up alerts. 

System Icon Icon Preview Description Helpful Hint
Altered/Unaltered  mceclip3.png Displays for an animal if they are unaltered. Displays red if unaltered and past set threshold. Displays blue if unaltered and within the threshold.  This threshold is set from the Altered by Month setting.  
Animal Photo  mceclip4.png Displays for an animal if there is a photo on record.   
Appointment Card  mceclip5.png When clicked, this icon will load an animal’s appointment card.   
Belongings  mceclip6.png Displays for an animal when there is a checked-in reservation. When clicked, this icon will load the animal's reservation belongings.   
Birthday  mceclip7.png Displays for an animal if their birthday is today.   
Check in Questions  mceclip9.png Displays for an animal if there are any check-in questions for their reservation.  
Dashboard Details  mceclip10.png Displays any owner, animal, and reservation form fields tagged to the dashboard.   
Employee Notes clipboard.png Displays any Owner or Animal Employee Notes saved to a pet's profile.   
Expected to Check Out  mceclip11.png Displays for an animal if their reservation scheduled to check out today. Displays yellow if the current time is before the scheduled checkout. Displays red if the current time is after the scheduled checkout.   
First Time Reservation  mceclip12.png Displays for an animal if there is not a checked out reservation on record.  
Immunizations mceclip16.png Displays for an animal if immunizations are expiring or expired. Displays yellow if any immunizations will expire within 30 days. Displays red if any immunizations are already expired. If a species does not require any immunizations, this will still show in red for animals without any immunization records in that species.
Incidents  mceclip13.png Displays for an animal if there is an incident record on file.   
Gingr PreCheck Form pre-check.png Displays if a client has filled out a Gingr PreCheck form for their pet's stay.  
Reservation Notes  mceclip15.png Displays any reservation notes associated with an animal's reservation.   


These icons can be enabled or disabled by navigating to Left-hand Navigation: Admin » Animals » Animal Icons.

To determine whether an icon is used in your app, use the Status toggle. If enabled, the icon will display wherever you see the animals' name in your app if they fall under the conditions of that icon.  



You can also optionally customize which system icons show up in Pop-Up Alerts. Pop-Up Alerts will display, if configured, for any of the following events: 

  • Checkout Alert: appears when the animal's reservation is added to the cart.

  • Checkin Alert: appears when the animal is checked in.

  • Reservation Creation Alert: appears when the animal's name is entered on the New Reservation and New Appointment page, when performing Quick Check-ins, as well as when managing reservation requests.

  • Owner Details Alert: appears when you visit the owner's profile.

  • Animal Details Alert: appears when you visit the animal's profile.

  • Reservation Details Alert: appears when you visit the reservation details page for the animal's reservation.


To include a System Icon on a Pop-Up Alert, enable the desired alerts by toggling them into the On position for the desired icon alerts. 



Custom Animal Icon Groups

Icon Groups can be used to separate or group icons into types, separate icons between locations, or to simply make it easier for staff to see important icons. Icon groups are not required to configure custom icons, but can be really useful if you have lots of types of icons or use separate icons between locations. 

To set up an icon group, follow these steps:

  1. Navigate to Left-hand Navigation: Admin » Animals » Animal Icons.

  2. Scroll down to the Click +Add to create a new icon group.


  3. Enter the groups' Name and which Location(s) icons of this type are used for. 


  4. Save

Once your group(s) are configured, Custom Icons can be created for these groups, and these icons will be sorted into groups in the display when you've added them to an animal.


Custom Animal Icons 

In addition to system icons, you are also able to create your own Custom Icons. To create a custom animal icon, follow these steps: 

  1. Navigate to Left-hand Navigation: Admin » Animals » Animal Icons

  2. Scroll down to the Animal Icons section, and click the +Add button. 


  3. Select an Icon from the drop-down menu by typing a keyword from its name and selecting the icon from the list.

    Check out the Font Awesome website to see a full list of available icons. Currently Installed Version: v5.13.1.


  4. Indicate, optionally, which Animal Icon Group this icon should belong to. 

  5. In the Title field, type a name for your icon.  (This is the label that will show up when you hover over the icon.)

  6. Click into the Color field to select any color from the color picker. If you do not select anything, it will default to black.

  7. Optionally set a Capacity for this icon. This feature allows you to set capacity limits for pets with specific icons assigned to them. This means that, for example, at any given time, you can only have X number of pets with a red flag icon.

  8. Optionally set this icon to produce any number of Pop-Up Alerts. 

    • Checkout Alert: appears when the pet's reservation is added to the cart

    • Checkin Alert: appears when the pet is checked in

    • Reservation Creation Alert: appears when the pet's name is entered in the Pet/s field on the New Reservation and New Appointment page, as well as when actions are selected when managing reservation requests.

    • Owner Details Alert: appears when you visit the pet's owner's profile

    • Animal Details Alert: appears when you visit the pet's profile

    • Reservation Details Alert: appears when you visit the reservation details page for the pet's reservation

  9. Save your icon! 


System-Wide Settings & Group Permissions

There are a few icon-related settings that can be managed from Left-hand Navigation: Admin » Animals » Animal Icons.

Setting Description Helpful Hint
Allow bulk icon deletion from pop-up alert       When enabled, users with permission to delete icons will be able to bulk remove icons from pop-up alerts. If disabled, users with permission to delete icons will still be able to remove icons from animals, they just won't be able to do so in bulk via Pop-Up Alerts.
Altered by month Displays the Altered/Unaltered system icon if a pet remains unaltered after this threshold.  
Fontawesome 5 Pro If enabled, your app will have access to Fontawesome 5 Pro icons, and you indicate that you have purchased a license for that use. To utilize this setting, you can purchase a license directly from Font Awesome ( for $99/year. Pro Versions will still only have access to v5.13.1 icons within Gingr.


Additionally, you can restrict the ability for users to be able to remove icons from owners or animals. To manage this permission, head to Left-hand Navigation: Reports and More Icon » Groups

Permission Description
Can Delete Icons If enabled, users can remove custom icons from owners or animals.


Lastly, you can set a preference for whether an owner's or animal's icons display in the shopping cart by heading to Left-hand Navigation: Admin » Shopping Cart and Point of Sale » Check Out Options

Setting Description
Show Custom Icons Cart            If disabled, you will not see an owner's or animal's assigned icons in the shopping cart.



How to: Using Animal Icons.  

Assigning an Icon to an Animal


Users can assign custom icons to animals from several places in the app, including the Animal Profile details page, Search Results page, Dashboard, and Quick Check-In panel. 

To add an icon to an animal, follow these steps:

  1. Find the Animal's name on any of the pages referenced above. 

  2. Click the light gray + icon, to see the Custom Icons available to add. 


  3. Select a custom icon by clicking on it.

  4. Optionally, type in the Comments field to add a description that will be unique to the selected animal. Please know there is a 250-character limit for the Comments section. This comment will display when you hover over the icon after it's been assigned to the animal.

  5. Optionally, to create an Employee Note (not visible to customers) with the comment entered for this icon, tick the Create Employee Note checkbox.

  6. Click the blue button to add the icon.



Removing an Icon from an Animal

If a custom animal icon no longer is relevant for an animal, you can remove the icon from the animal. To remove an icon from an animal, follow these steps:

  1. Find the Animal's name on any of the above-mentioned pages.

  2. Click the light gray + icon next to their assigned icons.

  3. Icons currently assigned to an animal will show up with a blue highlight. To remove an icon, click on it.

  4. Click the red Trash Can icon next to the comments field to remove the icon from the pet. 

  5. Click OK on the confirmation. 



Pop-Up Alerts

Icon Pop-Up Alerts are configured at the individual icon level to remind staff of certain icons on an animal when they are doing actions in Gingr with the animal such as creating a reservation, checking in the pet, viewing their profile, etc.

If an icon is set to trigger a Pop-Up Alert, the user will see a pop up that looks something like this: 


Using this Pop-Up, the user can read the comments on the icon(s) that were set for that pop up, as well as delete those icons if they are no longer relevant right from the pop-up. 


Most System Icons have special actions that can be taken when clicking on the text in the Description on a pop up. These actions include: 


System Icon Icon Preview Pop Up Action
Account Balance mceclip1.png Directs you to the Owner's account. 
Agreements  mceclip2.png Directs you to the Agreements section of the Owner's account.
Appointment Card  mceclip5.png Directs you to the animal's Appointment Card. 
Belongings  mceclip6.png Opens the Belongings for the animal's current reservation.
Incidents  mceclip13.png Directs you to view the animal's Incidents.
Package Credits  mceclip14.png Directs you to the Owner's account. 
Reservation Notes  mceclip15.png Directs you to the Reservation Details page. 




Hiding Icons in the Shopping Cart

In case you ever need to show your customer your shopping cart while you are ringing them up, but you don't want them to see the icons that are added to their pet, we've made it easy for you to hide the icons with one click. Before showing your customer your screen, simply click the Hide Custom Icons button in the shopping cart to hide the icons.



FAQ: The more you know.

  • Filtering the Dashboard by Icons
  • Viewing Animal Icon Counts from the Calendar Details Page
  • Hiding Icons from the Shopping Cart
  • Animating an Icon


Can I easily tell how many animals with certain icons are currently checked in?

Absolutely! On the Expected, Going Home, Checked In, Unconfirmed, and Requested sections on the Dashboard, you can easily limit the results to show animals with a particular icon. Follow these steps to limit your Dashboard by icon:

  1. Navigate to the Dashboard, and click to the section you'd like to review. 

  2. On the section, click the Search icon in the upper right of the results to toggle the search to Icon Search.


  3. Click into the dashboard search to pull up the icon dropdown list. Click on the Icon's Name to see a limited list of animals on the Dashboard that have the selected icon assigned to it. 


Can I see icon totals (for things like playgroups) from the Facility Calendar so that I can tell how much room I have left?

Yes! You can easily see icon counts on the Facility Calendar by following these steps:

  1. Navigate to the Facility Calendar » Click any Reservation Type on a Date.
  2. Click on the Icons tab to view the number of animals with each Icon.

  3. Filter the list by using the Search icons... field and sort the columns by clicking on the column headers.






I have an icon that I want to make absolutely certain my staff don't miss. What can I do to make it stand out?

If you already have Pop-Up Alerts set for a custom icon, but you'd like to ensure that it sticks out a bit more, you can set it up to spin in place. To set this up, follow these steps:

  1. Navigate to Left-hand Navigation: Admin » Animals » Animal Icons. Locate the custom animal icon you'd like to animate and click the Pencil icon to edit.

  2. Find the technical name for the icon, located in the Icon field. (i.e. fa fa-fighter-jet) and write it down.


  3. On the Animal Icons admin page, navigate to the Icon Classes page, which is found in the Related Pages section at the top of the page. 


  4. Search the Class column for the technical name of the icon that you wrote down in step 2. Locate the proper record, and then click the Edit button.


  5. Append " fa-spin" (without quotes, including the space) to the end of the Class field string. Do not change anything else. (i.e. fa fa-fighter-jet fa-spin)


  6. Click the Save button. Your icon should now be spinning! 




Was this article helpful?

2 out of 3 found this helpful

Have more questions? Submit a request



Article is closed for comments.

Powered by Zendesk