Skip to content

Help with the app.

How-tos for guest mode, accounts, care, QR labels and data. If something is missing, write to kontakt@herplabs.org.

Getting started and guest mode

How do I use HerpLabs as a guest?

Tap “Get started” in the app or on herplabs.org. You go straight to your collection, without an e-mail address or password. In an empty collection you can look at example animals and delete them again with “Remove examples”.

Almost everything works as a guest, photos and reminders too. Only sharing an animal pass, QR labels, exporting data and importing data need a saved collection.

How do I save my collection?

Tap “Save your collection” (on the overview or under Settings → Create account). The quickest way is “Continue with Apple”. Or enter your e-mail address, confirm it with the link in the e-mail and then set a password. Everything you created as a guest stays, and from then on you can sign in on any device. No e-mail? Please check your spam folder too.

As long as you are a guest, your collection is tied to this device. If you delete the app or your browser data, or sign out as a guest, the data is lost. We automatically delete guest accounts that were never saved after 60 days without activity.

What if it says this e-mail already has an account?

Then there is already a HerpLabs account for that address. You can sign in with it, but your guest collection will not move over and can no longer be reached on this device afterwards. To keep it, save it with a different e-mail address.

Account and signing in

How do I create an account?

The easiest way is to tap “Get started” and later “Save your collection”. Or use “Continue with Apple” right away. With e-mail it works like this: tap “I already have an account”, then “Create account” at the bottom, and confirm your e-mail address with the link we send you.

Can I sign in with Apple?

Yes, with “Sign in with Apple” you don’t need a password. If you choose “Hide My Email” at Apple, we only receive a forwarding address, and Apple forwards e-mails from HerpLabs to you. Already have an account with e-mail and password? Then sign in as usual and, under Settings → Account, tap “Connect” next to “Sign in with Apple”. Otherwise you end up with a second, empty account.

How do I reset my password?

When signing in, tap “Forgot?” next to the password field. You get a link to set a new password. On iPhone the link opens the app directly if it is installed.

Care and reminders

When is an animal due?

That depends on the intervals in the animal’s care profile (Settings → Care profiles). A refused feeding does not reset the time. While an animal is marked as “In shed”, feeding is paused.

How do feeding reminders work?

In the iPhone app, turn them on under Settings → Reminders and choose a time. As long as an animal is due, you get one notification a day; animals in shed are left out. If no notifications arrive, check in the iOS Settings under Notifications → HerpLabs that they are allowed.

How does the feeder stock work?

Under Feeder stock (on the overview, in the sidebar on a computer) you add items such as "Mouse · Adult, 18–25 g, frozen" and log purchases. Each feeding with a matching feeder and weight takes one piece; the entry sheet and the feeding round show which item it is before you save, and you can change it. Deleting a feeding puts the piece back.

A refused frozen feeder counts as used, a refused live one doesn't. Insects are added as packs that you mark as used up by hand. When an item lasts less than two weeks at your animals' feeding intervals, it shows on the overview under "Feed".

QR labels and sitters

How do I print QR labels for the enclosure?

In the profile, tap the QR icon at the top (or “QR label” in the details), choose a style and size and tap “Print (PDF)”. For several animals at once, use the QR icon at the top of the animal list. In the app the share sheet opens: “Print” for AirPrint. Several printouts carry the same code. Under “Details” you can leave out what you don’t need, such as species or hatch year. Name and QR code are always on the label.

Labels print in black and white on plain paper; cut them out along the crop marks. Under “Size”, choose Small (92 × 43 mm, 12 per page), Medium (136 × 62 mm, 6 per page, landscape) or Large (186 × 87 mm, 3 per page). Under Custom you enter width and height yourself. Print at 100% if you can. If the printer shrinks the page a little, the crop marks still line up.

Under “Paper”, choose A4, US Letter or Single for label printers, with each label on its own page of the PDF. On US Letter, Medium and Large are a little smaller. If a label is too small for a reliable QR code, the app tells you the minimum size. For film read from the back, use Mirror. On clear film the code needs something light behind it, or it won’t scan.

Under “Custom” there are templates for common label sheets (Avery) and label printers (Brother, Dymo). For other sheets, choose Label sheet and enter the top margin, left margin and gaps. You’ll find them on the pack or in the maker’s template. Print label sheets at 100%, not “fit to page”. “Print outlines” shows on plain paper whether everything lines up.

If you scan the label yourself with the iPhone camera, the animal opens directly in the HerpLabs app (version 1.1 or later). Without the app it opens in the browser if you are signed in on herplabs.org. If your sitter uses HerpLabs too, their app shows your animal’s care card in the browser. “Generate new code” makes every label printed so far invalid, for example if a label has ended up in the wrong hands.

How does sitter access work?

When you go on vacation, turn on sitter access under “QR label”, for one animal or for several in the animal list, each until a date. Whoever scans the label then sees a care card without an account: photo or cover, name, species, what and how much it ate last, whether a feeding is due and your note. With large buttons, the sitter logs fed, refused, poop, shed and notes; the entries appear in your journal marked “Sitter”. You can also send the link directly (“Send link”).

The card shows only this one animal, nothing from your notes and no other animals. An entry made by mistake can be undone for 30 minutes; the card takes no more than 20 entries and 3 feedings per animal and day. After the end date, or when you turn access off, the label only shows that it belongs to HerpLabs.

Data and devices

Is my data the same on all devices?

Yes. The app and the website use the same account. Your data is stored in the cloud (in the EU) and is the same everywhere once you are signed in. As a guest you can’t sign in elsewhere yet: save your collection to open it on other devices too.

How do I export my data?

Under Settings → Export data you get all animals, entries and breeding data as a JSON file. In the app you can use the share sheet to save the file, for example to “Files”.

How do I delete my account?

Under Settings → Delete account (as a guest: Delete guest access). This permanently deletes your account, all entries, your animal photos, animal passes and QR labels. Export your data first if you want to keep it.