User Guide

2 Stash home

This is the main screen after welcome or sign-in. Rings mark each control; the number sits beside it.

1. 1
2. 2
3. 3
4. 4
5. 5
6. 6

1. 1 Tap Filters to search and narrow the stash.
2. 2 Tap the sort chip (here Brand) to change sort order. The arrow beside it flips A–Z / Z–A.
3. 3 Tap the list/grid icon to switch views.
4. 4 Tap ☰ for credits, About, Settings, and sign in or out.
5. 5 Tap the cloud icon to sync (shown when signed in, or when a guest has Ravelry linked).
6. 6 Tap + Add Yarn to create a yarn.

• Yarn count — “54 yarns”, or “12 of 54” when filters are on.
• Offline banner — appears at the top with no internet.
• Empty stash — prompts you to add yarn.
• Pull to refresh — pull down to sync when online.

Menu

1. 1
2. 2

1. 1 Home, About, and Settings. Sign Out / Sign In is at the top of the menu.
2. 2 Smart Scan Credits shows your remaining scans. Tap Buy for more.

Back

Back leaves selection first, then closes Filters, then clears filters, then leaves stash. On a phone that is the system Back control; on iOS it is the back arrow at the top of the screen.

3 Browse & organize

List view

1. 1
2. 2

1. 1 Tap the list/grid icon to switch back to photos.
2. 2 Tap a yarn row to open and edit it.

Sort

1. 1
2. 2
3. 3

1. 1 Tap Brand (or the current sort name) to open this dialog.
2. 2 Tap a sort: Name, Colorway, Brand, Total Length, Weight, or Date Updated.
3. 3 Tap Close without changing, or pick a sort to apply and dismiss.

Filters & search

1. 1
2. 2
3. 3

1. 1 Tap Filters to show or hide this panel (highlighted when open).
2. 2 Type in Search your stash… — matches brand, name, colorway, color, dye lot, and notes.
3. 3 Tap chips for groups, brands, fibers, weights, and colors. Fiber OR / AND changes how multiple fibers combine. Handspun and Length & Weight are further down the same panel.

4 Add, edit & delete yarn

1. 1
2. 2
3. 3
4. 4

1. 1 Tap the camera tile to add photos (camera or gallery). Up to 4. Trash icons remove a photo.
2. 2 Smart Scan stays disabled until you add a photo. After that it needs credits and internet.
3. 3 Tap Add Yarn (disk) to save. The same button reads as save when you are editing.
4. 4 Tap back if you need to leave. Unsaved changes ask you to discard or stay.

Edit

Tap a yarn on the stash to open Edit Yarn, change fields, then tap the save button.

Possible duplicate

If a new yarn looks like one you already have, choose Cancel, add skeins to the match, or save as new.

Delete

On Edit Yarn, use delete in the app bar. Or long-press on the stash list and use Delete (see Selection).

Another colorway

In Basic Info, tap Add Another Colorway when you have the same yarn in a different color. Yarn Stasher copies the rest of the entry (brand, name, weight, fibers, and so on). Photos, colorway, and amount start empty so you can fill those in for the new color.

5 Photos & Smart Scan

Smart Scan is how Yarn Stasher reads yarn-label photos and fills in the form. You can attach up to 4 photos; one scan still uses one credit, even if several photos are attached. The more label data that is visible (brand, colorway, weight, fiber, yardage), the better the fill. Keep labels in frame, well lit, and in focus.

1. 1
2. 2

1. 1 On Add Yarn, add up to 4 photos, then tap Smart Scan. That uses one credit (not one per photo) and needs internet. The app fills brand, name, colorway, yarn weight, fibers, and yardage. Open View analysis details if you want to see how it read the photos.
2. 2 Always check the fields — scans can misread a label. Fix anything wrong, then tap Save Changes (or Add Yarn on a new entry).

6 Yarn fields

Each yarn has Basic Info, measurements, fibers, groups, and extra notes. Some Basic Info fields lock when the yarn is linked to the Ravelry database.

1. 1
2. 2

1. 1 Brand, name, colorway, yarn weight, and closest color. Add Another Colorway copies this yarn except photos, colorway, and amount (see Add yarn).
2. 2 Skein count, length per skein, and weight per skein. Totals update as you type. Units follow Settings (meters/yards, grams/ounces).

Measurements & calculator

Skein count, length per skein, and weight per skein (meters/yards, grams/ounces). Totals update as you type.

1. 1
2. 2
3. 3

1. 1 Subtract — enter skeins (or length/weight) you used.
2. 2 Add — enter skeins you bought.
3. 3 Remaining — enter how much yarn is left; Yarn Stasher estimates the new skein count.

Open it from the yarn form: scroll to Measurements and tap Skein Count Calculator.

Fibers, groups, extra

• Fibers — name + percentage rows; stash names autocomplete
• Groups — name a project, bin, or season; groups also appear as filter chips
• Extra — dye lot, needle size, gauge, notes, hand spun

Per-yarn Ravelry catalog linking is on the yarn form. See Ravelry yarn database.

7 Selection & groups

1. 1
2. 2
3. 3

1. 1 Long-press a yarn until checkboxes appear, then tap others to add them.
2. 2 Tap Delete (asks for confirmation), or use Assign group / Remove group.
3. 3 Tap Cancel to leave selection mode.

8 Smart Scan credits

1. 1
2. 2

1. 1 Open ☰ → Buy, then tap a pack. Guests may be asked to sign in first.
2. 2 Use Restore Purchases after a reinstall or device switch. Buying needs internet.

One Smart Scan uses one credit, even if you attached up to 4 photos. Credits are not used when you add photos or save a yarn by hand.

Bonus credits

• New device: Yarn Stasher automatically adds 3 Smart Scan credits once per device, whether you start as a guest or sign in. Reopening the app does not grant them again.
• Email verification: An email/password account can claim 10 credits once after verifying its email. In Settings, complete email verification and tap the check/claim action.
• Guest transfer: If you later sign in, the transfer prompt can move any remaining guest credits on that device into your account.

9 Sync & backup

Yarn always stays on this device. Where else it is copied depends on how you signed in:

• Ravelry linked (guest or Yarn Stasher account) — stash syncs only with Ravelry. Yarn Stasher cloud is not used.
• Signed in, no Ravelry — stash backs up to Yarn Stasher’s cloud.
• Guest, no Ravelry — local only; nothing is backed up off the device.

Tap the cloud icon on stash, pull down to refresh, or open Settings and tap Sync Stash Now.

10 Ravelry

1. 1
2. 2
3. 3
4. 4

1. 1 Tap Re-auth if Yarn Stasher needs a fresh Ravelry login.
2. 2 Tap Ravelry to open your Ravelry profile in the browser.
3. 3 Tap Unlink Ravelry Account to disconnect. To link the first time, tap the Ravelry card, finish browser login, and return to the app.
4. 4 Theme sits below Ravelry — dark toggle, or System / Light / Dark.

If the Ravelry token expires, the app asks you to sign in again. Matching a yarn to Ravelry’s catalog is separate — see Ravelry yarn database.

11 Ravelry yarn database

This is not the same as linking your Ravelry account. Account linking syncs your stash. Database linking matches one yarn to an official Ravelry yarn page so Ravelry treats it as that product and can fill missing details.

1. 1

1. 1 Tap Link to Database Yarn (your Ravelry account must already be linked). Yarn Stasher searches Ravelry for yarns with similar brand, name, weight, and other fields. Pick a match to register it in Ravelry’s database and fill any missing catalog info. Brand, name, yarn weight, and fibers then lock because they come from Ravelry. Skip to keep a personal yarn with your own details.

The same search can appear during stash sync for yarns that are not matched yet. On a linked yarn you can View on Ravelry or Convert to Personal Yarn to unlock those fields again.

12 Settings

Open ☰, then tap Settings. Cloud Sync, Ravelry, and Theme are at the top (see Ravelry). Scroll for units and help.

1. 1
2. 2

1. 1 Under Units, tap Meters or Yards, and Grams or Ounces.
2. 2 Help & Legal has this user guide, Privacy Policy, Terms, and Contact Support. Account (signed-in) is below.

Email verification lives near the top of Settings — resend or confirm, then claim starter credits when eligible.

13 Account

1. 1

1. 1 Settings → Linked Accounts: password, Google, Facebook, and Apple (iOS / macOS). Forgot password sends a reset email.

Tap Sign Out in the menu to return to Sign In.

To delete your account: Settings → Account → Delete account. Re-authenticate, then confirm. This cannot be undone. See Account Deletion.

14 Offline

• An offline banner appears on stash, sign-in, settings, buy credits, and account screens.
• You can still browse and edit the local stash.
• Sync, Smart Scan, purchases, and most account changes need a connection.

15 Troubleshooting

Smart Scan will not run

Need a photo, internet, and credits. Verify email for free credits if asked.

Sync failed

Confirm you are online. Settings → Sync shows the error. For Ravelry, tap Unlink / link again or re-authenticate.

Ravelry will not link

Finish login in the browser and allow the app to reopen. If it does not return, start again from Settings.

Purchases missing

Tap Restore purchases on Buy Credits while online, using the same store account.

Guest stash missing after sign-in

If you skipped the transfer dialog, data may still be only on that device. Email support if you need help.

Filters show zero yarns

Clear filters or go Back, then search with fewer chips.

16 Privacy & support

• Privacy Policy
• Terms of Service
• EULA
• Email: support@yarnstasher.com
• Website: yarnstasher.com

In the app: ☰ → About, or Settings → Help & Legal.

17 Glossary

Stash

Your yarn entries in Yarn Stasher.

Guest mode

Use the app without a Yarn Stasher account; data is primarily local.

Smart Scan

Reads label photos and fills yarn fields; uses scan credits.

Scan credits

Balance for Smart Scan; from email verification or in-app packs.

Groups

Labels for projects, storage, or any custom set of yarns.

Cloud sync

Yarn Stasher cloud backup for signed-in accounts that are not linked to Ravelry. If Ravelry is linked, stash syncs only with Ravelry.

Ravelry link

OAuth connection that syncs with your Ravelry stash.

Database-linked yarn

A stash entry matched to an official Ravelry yarn page. Catalog fields can fill in and then lock; convert to personal to unlock them.

Colorway

Named color or dye of a yarn.

Closest color

Simple color category for browsing and filters.

Index

• Add yarn
• Apple / Google / Facebook
• Calculator
• Sign in
• Delete account
• Filters
• Guest mode
• Groups
• Grid / list
• Offline
• Photos
• Ravelry
• Ravelry yarn database
• Selection
• Settings
• Smart Scan
• Sort
• Sync
• Theme & units