A nickname is a personal label you can attach to a specific coin or bar — the one Grandma left you, the first piece you ever bought, the bar in the bottom of the safe with a tiny ding on the corner. It doesn't change the product, the cost, or the math. It just gives the piece a name you'll recognize.
This article covers where to set one, where it surfaces, and how to use it without painting yourself into a corner three years from now.
For the broader picture of the three label fields and how they all work together, see How holdings work in Gold Silver Ledger.
What a nickname is, and what it isn't
A nickname is free-text. Anything you want — a person's name, a memory, a description. It rides along with the specific inventory item it's attached to, not with the product.
Six American Gold Eagles can have six different nicknames, or none, or one nickname on one of them and nothing on the other five.
What a nickname does:
It identifies one specific piece. The label moves with that piece through every view in the app.
It surfaces in search. Type a word from a nickname into the Holdings search bar and you find the piece, regardless of which metal or product it is.
It exports. Nicknames travel along with the rest of the per-item data in CSV exports of your holdings.
What a nickname doesn't do:
It doesn't affect any number on the page. Cost, weight, current value, gain or loss — none of these change. Naming a coin "lucky" does not, in fact, make it lucky.
It doesn't transfer to other items of the same product. If you nickname one Gold Eagle "Grandma's coin," your other Gold Eagles stay nameless until you give them their own.
It doesn't show on transactions. Nicknames live on the inventory item, not on the buy transaction that created it. The Transactions page shows transaction-level labels (the transaction name); the Holdings page shows item-level labels (the nickname).
Opening the Edit Labels modal
The nickname field lives inside the Edit Labels modal. Three paths to get there, depending on which view you're in:
Group view: Expand the metal, then the product, then the individual item. The expanded item shows a detail strip with an Edit Labels button at the right edge.
Item view: Expand the product row. Each item underneath has an Edit Labels button at the right of its row.
Card view: Click the small pencil icon at the top-right of any card.
All three open the same modal, with the same three fields: Nickname, Reference, and Date. This article focuses on the first one.
Setting a nickname
Click into the Nickname field at the top of the modal. Type whatever you want. The hint underneath the field reads "A personal label to help you identify this item." — keep that brief, since the nickname is what shows up in the small space under the item number when you're scanning a list.
Click Save to commit. The nickname is applied to that item only and starts surfacing immediately in the places listed below.
If you want to leave the field empty, click Cancel instead — that closes the modal without writing anything.
Where the nickname shows up
A nickname surfaces in three places in the app:
Under the item number in group view. The deepest level of the drill-down shows the item number (#1, #2, #3…) with the nickname directly underneath it, where the secondary text would otherwise be blank. This is the most visible spot.
Under the item number in item view. Expanding a product row exposes its individual items with the same numbered-row layout, so the nickname surfaces here too.
Under the product type in card view. The nickname appears after the item type (American Gold Eagle) and before the metal, form, and reference tag.
In search results. The Holdings search bar matches against nicknames in addition to product names. Type a word from a nickname and the page filters down to that one piece (and any other items whose nicknames or product names also match).
Changing or clearing a nickname
Same modal, same field. Reopen Edit Labels, type the new value over the old one (or delete the existing text entirely), and Save. Clearing the field by deleting the text and saving removes the nickname from the item.
There's no separate "remove nickname" button. An empty field saved over a populated one is how you blank it out.
Patterns for picking good nicknames
Three patterns that hold up over time, plus one that doesn't.
Provenance: "Grandma's coin," "first APMEX order," "1995 birthday gift," "the show in Reno." Memorable, durable, and the kind of thing you'll still recognize years later.
Physical identification: "tiny ding on rim," "spot on Liberty's cheek," "scratched edge." Pairs well with high-value or numismatic pieces where you might need to physically pick one specific coin out of a few that look similar.
Purpose or earmark: "emergency fund," "wedding savings," "kid's college." Useful for stackers who think of subsets of their stack as having different jobs, but who don't want to split those subsets into separate portfolios.
The pattern that doesn't hold up:
Generic descriptors that don't disambiguate: "the nice one," "good condition," "favorite." If you have only one of the product, these are fine. If you have several of the same product, you'll be back here in six months trying to remember which one was "the nice one."
Nicknames vs. references vs. date annotations
The three label fields are siblings, and they don't compete for the same job:
Nickname: A human-readable name. Used for identification and for sentimental or organizational tags.
Reference: A short identifier — a serial number, a storage location code, your own SKU. See Adding a user reference (serial number, storage location).
Date annotation: A free-text date that isn't the purchase date. Mint year is the most common use. See Adding a date annotation (mint year).
It's normal to set one without the others — most users have nicknames on a few sentimental pieces, references across the whole stack for storage tracking, and date annotations only on numismatic pieces where mint year matters.
Where to go next
How holdings work in Gold Silver Ledger: The foundation article — item-level inventory, per-item fields, and the three labels.
Adding a user reference (serial number, storage location): The reference field, with patterns for using it as a free-text storage-location index.
Adding a date annotation (mint year): The third label and what it's most often used for.
Filtering and sorting your holdings: How search interacts with nicknames, references, and the filter row.