Herbarium Help and Support

Learn how to use Herbarium for iOS 0.1.4. Look for your version when the steps differ.

Getting started

Use your on-device library to record yarn, projects and patterns without creating an account. Your records stay on this device by default. Open Settings → Backup & Restore in 0.1.2, or Settings → Device Storage & Backup in 0.1.1, to check device storage and manage backups and optional iCloud sync.

In 0.1.3 and 0.1.4, go to Settings → Sync & Backup to check your sync status, save a backup, or restore your library.

Sign in

Tap Log in on the welcome screen, or choose Sign in to sync your library in Settings. New accounts are created with Sign in with Apple. Choose Sign in to an existing account to use your original email address. In the mainland China App Store, you can also use an eligible phone number already linked to your account. Available options are shown in the app.

If a code does not arrive, check your email address or phone number. For email, check your spam folder as well. Avoid requesting codes repeatedly. Contact support if you still need help.

iCloud sync

Turn on sync

In Settings, tap Sign in to sync your library and complete sign-in to enable automatic sync. If you are already signed in on 0.1.4, choose Enable Auto Sync in Settings → Sync & Backup → Sync Settings. On 0.1.3, open Manage iCloud Sync. Restoring an existing sign-in keeps this device’s previous sync setting; it does not turn sync on by itself.

Check the status

Keep the app open and view progress in Sync & Backup. Synced appears only after a complete version of the records, photos, and attachments has been confirmed. If asked to finish editing and close the sync page, save your edits and close it; the app will continue syncing.

When sync pauses or you change devices

Changes stay on your device when iCloud is unavailable or full. After resolving the issue, reopen Herbarium to resume, or tap Resume Sync. If both the device and iCloud copies have changed, keep both copies. On 0.1.4, tap View Differences to compare them. The iCloud restore point shows the last copy confirmed for recovery. Check the sync status for current progress.

On another device, use the same iCloud account in system settings, sign in to Herbarium, and enable sync. You can retrieve data that has successfully synced. Changes saved only on the old device must be synced there first or transferred using a complete exported backup.

Turn off sync

In 0.1.4, go to Settings → Sync & Backup → Sync Settings to turn off sync. In 0.1.3, open Manage iCloud Sync. Turning it off does not delete the device library or the existing iCloud copy.

Manual sync in earlier versions (with a Sync Now button)

First-time setup

Sign in to Herbarium. In 0.1.2, open Settings → Backup & Restore → iCloud Sync. In 0.1.1, open Settings → Device Storage & Backup and find the iCloud sync section. Agree to sync and tap Choose My iCloud.

Each time you sync

Save and finish editing, tick the confirmation box, then tap Sync Now.

Your records sync to the private storage of the iCloud account on your device. On another device, use the same iCloud account in system settings, then start sync in the app. Turning off sync keeps your device data and existing iCloud copies.

In 0.1.2, find the steps for signing out of iCloud on your device in Settings → Herbarium Account → Account Help.

Clear your iCloud copy

In 0.1.4, go to Settings → Sync & Backup → Sync Settings → More Actions → Clear iCloud Copy. In 0.1.3, open Clear iCloud Copy directly from Sync & Backup. In 0.1.2, find it under Backup & Restore.

On the clear copy screen, tap Verify iCloud Account. After the app verifies the current iCloud account, make sure your other devices have finished syncing, tick the confirmation box, and tap Clear iCloud Copy.

This removes the private sync copy in the current iCloud account and turns off sync on this device. Your on-device library, shared lists and exported files are kept. To upload again, enable automatic sync in the new interface. In the earlier manual interface, set up sync again and tap Sync Now.

Share a yarn list

After signing in, go to Settings → Share yarn with friends or family and tap Select yarn to share. Name the list, select the yarn, then tap Invite through iCloud. Invitees can open the invitation with iCloud to see the yarn details as they were when you shared the list. The list is read-only and excludes photos, notes and files.

To remove invitees or stop sharing, tap Open shared yarn collections and open your own list. After deleting your Herbarium account, you can still manage sharing with the iCloud account you used to create the list. Revoking access does not delete copies recipients have saved themselves.

Backup and restore

Save a backup file in 0.1.4

Go to Settings → Sync & Backup → Save a Backup File. Set a password, tap Create Encrypted Backup, then Save Encrypted Backup. Use the system share sheet to save to On My iPhone, a computer, or another available location. Check that the file is there, and keep your backup and password safe. The backup contains your saved records, photos, and attachments.

Restore from a backup in 0.1.4

With an empty library, go to Settings → Sync & Backup → Restore from Backup. Tap Choose a Backup File, enter the password you used to create it, then tap Start Restore. Herbarium checks the file before restoring it to this device. When you see Restore Complete, tap View My Yarns and check your photos and attachments. Check Sync & Backup separately for iCloud progress.

0.1.3 and earlier

In 0.1.3, choose Export Backup or Restore Backup in Settings → Sync & Backup. To verify a saved file, select it and tap Verify Backup. Restore requires an empty library.

In 0.1.2, open Settings → Backup & Restore → Local Backup & Restore. This page also lists pending backups. In 0.1.1, open Settings → Device Storage & Backup and find Encrypted backup & restore. Keep your exported backup file and password in a safe place. Restore requires an empty library. Keep your existing records if you are troubleshooting a restore.

If storage is low or a save or sync is interrupted, keep your existing data and any error message. Avoid deleting the app or clearing data to troubleshoot. If you are unsure of the result, contact support.

Delete your account and check progress

Request deletion

After signing in, go to Settings → Herbarium Account → Manage account and receipts and find Delete account. Tick the confirmation box, tap Request deletion, then tap Continue and generate a private receipt. In earlier versions, the request button may say Record a cloud account deletion request.

Save your receipt and verify your identity

Tap Save private receipt file and save it to your device, confirm that the file is in Files, then return to the app and tick I saved this private receipt securely.

Follow the on-screen steps to verify with Apple or a verification code. Type “Delete account” and tap Submit request and freeze cloud account.

Check progress

On the account page, open Deletion receipt and progress. If you’ve signed out, open Settings → Herbarium Account and tap Sign in to Herbarium in 0.1.2 or Sign in or register in 0.1.1 to return to the account page. You can check without signing in. Use the receipt shown there or tap Import a private receipt from this device, then tap Check deletion status.

An accepted or frozen status means processing is under way. The receipt shows when deletion is complete. Keep your receipt private and contact support if you cannot check the result.

On-device data and existing iCloud copies remain after account deletion.

Contact us

Include your app version, device and system version, the time it happened and a description of the issue. You can include a relevant screenshot with personal information covered.

Keep passwords, verification codes, full receipts and lookup credentials private. Please leave out unrelated personal photos or files.

Recover data from the previous cloud service

If you already have an encrypted legacy recovery file, or the original device has a recovery copy or an unfinished restore, go to Settings → Sync & Backup → Device Storage → Recover data from the previous cloud service in 0.1.4 and follow the prompts. Importing a file requires an empty library.

If your data only exists in the previous cloud service, a new self-service export is currently unavailable. Keep your original device and any files, and contact support through the legacy help page. Keep passwords, verification codes, and private receipts secure.