Toko · Consistency reference
Tokens — Add.
Getting token definitions into a collection. Upload a batch of assets here, choose from assets already in the project, or build them in a generator and use its Export — all land as Draft tokens. The uploader keeps the common case simple (drop, tag, upload) and tucks per-batch settings behind Advanced options. Pressing Upload checks project cycles; uploads are size-capped per session and tracked per asset.
01No tokens (empty)First run. Two ways in: build tokens in a generator and export them here, or upload one or more assets.
Collection · Tokens
Tokens.
Token definitions are prepared here in Draft and Review, then set Live and minted.
Draft
No tokens yet.
Bring in tokens from a generator, or upload one or more assets to create them yourself.
Build in a generator
Create a new generator, or use an existing one.
Create from assets
Upload one or more assets to create your first tokens.
02Add assets — drop & tag (default)Step 1. Drop assets on the left, tag them, and watch them land on the right. Per-batch settings sit behind Advanced options. The session is capped at 100 MB; Upload is disabled until at least one asset is added.
Add tokens
Upload assets to create new tokens. Each asset becomes one Draft token.
Drop assets here or browse.
See supported file types →
Upload size0 of 100 MB
Non-public keywords; applied to every token in this batch and searchable in Manage.
Assets to upload0 added
Dropped assets show here with a preview before you upload.
03Add assets — added, ready to uploadStep 2. All assets are added and listed (none uploaded yet). You can still drop more, tag, or remove. Pressing Upload runs the project cycles check first, then begins uploading.
Add tokens
Upload assets to create new tokens. Each asset becomes one Draft token.
Drop more or browse.
See supported file types →
Upload size9.0 of 100 MB
spring ✕fox ✕
Assets to upload6 added · not uploaded
Image001.png 1.8 MBReady
Image002.png 1.8 MBReady
avatar16.gif 0.03 MBReady
Image004.png 1.8 MBReady
Image005.png 1.8 MBReady
Image006.png 1.8 MBReady
04Add assets — uploading (in progress)Step 3. Upload was pressed and cycles passed. Adding more is paused, each asset uploads on its own bar (blue → green → red), the header counts done vs total and an overall meter shows batch progress. The window stays open until it finishes.
Add tokens
Uploading — keep this window open until it completes.
Adding more is paused
You can add another batch once this upload finishes.
Upload size9.0 of 100 MB
springfox
Assets to upload3 / 6 uploaded
Uploading 6 files58%
Image001.png 1.8 MB100%
Image002.png 1.8 MB100%
avatar16.gif 0.03 MB100%
OpaqueImage004.png 1.8 MB62%
Image005.png 1.8 MBQueued
Image006.png 1.8 MBQueued
05Add assets — upload completeStep 4. All uploads finished and Draft tokens were created. The window stays open and switches its actions to "Add more files" (starts a fresh, empty batch) or "Close".
Upload complete
6 assets uploaded · 6 Draft tokens created.
All 6 assets uploaded. Each became a Draft token — edit them in the Draft gallery. Add another batch, or close to return to the token list.
Upload size9.0 of 100 MB used
Uploaded6 / 6 uploaded
Image001.png 1.8 MBDone
Image002.png 1.8 MBDone
avatar16.gif 0.03 MBDone
OpaqueImage004.png 1.8 MBDone
Image005.png 1.8 MBDone
Image006.png 1.8 MBDone
06Add from existing assetsThe "Use existing" tab. The left pane keeps the same tags + advanced options (no drop/browse box); the right pane lists every project asset that isn't a banner, with multi-select. No upload needed — picked assets become Draft tokens directly.
Add tokens
Pick assets already in this project. Each selected asset becomes one Draft token.
spring ✕
Applied to every token created from the selection.
Advanced options · applied to all selected
Project assets4 selected
07Asset row statesThe per-asset row in every state: ready/queued, uploading (blue), complete (green), complete with a validation warning ("Opaque"), and failed (red, with retry). Delete removes the asset from the batch.
Image001.png 1.8 MBReady
Image002.png 1.8 MB60%
Image003.png 1.8 MB100%
avatar16.gif 0.03 MB100%
Opaque · no transparencyImage004.png 1.8 MBFailed
Upload failed · retry08Advanced — Token typeThe token-type control appears only when the collection has more than one type. With a single type it's auto-assigned silently and never shown.
Token type · Allowed (multi-type)
Advanced options
3 token types in this collection — one choice applies to the whole batch; override individual tokens later.
Token type · Not allowed (single type)
Single token type — auto-assigned, so no selector is shown here.
09Advanced — Max copies per tokenThe copy-quantity field appears only when the collection allows copies. On a Single-only (1/1) collection it's hidden.
Max copies · Allowed
Advanced options
Applied to every token in this batch. Capped by the per-token hard maximum (200) set in Supply; edit individual tokens later.
Max copies · Not allowed
Single (1 / 1) collection — copies aren't allowed, so this field is hidden.
10Advanced — Rarity (by collection mode)The rarity control follows the collection's rarity mode: Uniform shows nothing, Tiered picks a tier, Weighted picks Common / Uncommon / Rare and warns that a choice here is a manual override.
Rarity · Uniform
Uniform rarity — every token is equal, so no rarity field appears.
Rarity · Tiered
Advanced options
Pick one tier, applied to all. Change individual tokens afterwards.
Rarity · Weighted
Advanced options
Choosing a tier here is a manual override applied to the whole batch — those tokens keep that tier through a rebalance, and it counts against that tier's quota. Leave it not set to let Final Score assign tiers automatically.
11Add tokens · low balance (upload blocked)The cycles check runs when Upload is pressed. If the project is short on blob storage the upload is blocked — the batch stays staged and the primary action becomes Top up & add tokens. Topping up swaps this same modal to the top-up step in place; it never stacks a second window.
Add tokens
Upload assets to create new tokens.
6 assets staged · 42 MB · uploaded & held
Estimated cost
~0.42 T cycles
Project balance
0.300 T
Shortfall
~0.12 T + reserve
Not enough cycles to store this batch. Your 6 assets stay staged — top up and they'll store straight away. Nothing is lost if you top up now.
12Top up to continue · batch staged (step in place)The top-up runs as a step inside the Add tokens modal — same window, content swapped, the upload waiting behind it. The back arrow returns to the blocked upload without topping up. Once cycles land the staged batch stores automatically.
Top up to continue
A step inside Add tokens — your upload is waiting.
6 assets staged · 42 MB · ready to send
This upload (est.)~0.42 T
Project balance0.300 T
Recommended top-up (cost + reserve)1.000 T
Top up amount
T cycles · ≈ 0.30 ICP
from your wallet to the project canister
Cycles are sent to the project canister; Toko moves what's needed into blob storage. After it lands, the staged batch stores automatically.
13Topped up · batch stored (step in place)Success is confirmed in the same modal — not as a toast glued to the page footer, where it can be missed. New balances are shown and the staged batch stores. "Back to upload" returns to the waiting upload step. Still one window throughout.
Topped up — finishing
A step inside Add tokens — returning you to the upload.
Added 1.000 T cycles. Balance is now 1.300 T. The staged batch is storing now — top-ups also appear in the project's activity log.
6 / 6 storedComplete
Cycles used0.42 T
Balance remaining0.88 T
14Supported file types (popover)A read-only reference, so it doesn't take over the modal or stack a blocking dialog. It opens as a small popover anchored to the "See supported file types →" link — glance, dismiss, and you're still on your upload. Same list used for generator parts.
Supported file types
Quick reference · popover
Still images
For most visual tokens — characters, items, art pieces, backgrounds.
.png · .jpg · .jpeg · .webp
Animated
For tokens that move — sparkle effects, blinking, flowing capes. Animation plays in the token preview and on the secondary marketplace.
.gif · animated .webp · .apng
Vector
Crisp at any size — good for geometric or text-based tokens.
.svg
Audio
For sound tokens — soundtracks, voice clips, ambient loops. Plays alongside the visual in the token preview.
.mp3 · .wav · .ogg · .m4a · .flac
Each upload is capped at 100 MB total; oversized files are rejected before upload.