List, transfer or delist many pieces at once

How to select a lot of pieces and run one action over all of them, what the limits are, and why only one batch can run at a time.

Doing the same thing to forty pieces one at a time is not a plan. The Bulk Manager takes a selection and runs one action over all of it: list at a price, transfer to somebody, or take them off sale.

What you need

  • A wallet, unlocked. Each piece is signed with your keys, same as if you did them by hand.
  • Enough BSV: the fee is per piece, not per batch. Forty listings cost forty listing fees. See Fees.
  • A subscription for list, transfer and delist in bulk. Bulk claim is the exception — see Claim a piece. Without one, the Bulk Manager tells you so instead of failing:
This is for verified users

You need to unlock this to use access_gate.feature_offers.

What you get without a subscription: the reason, and the way to fix it

Choosing what it operates on

Everything starts in your wallet, and both ways are buttons that are not there until you do something.

1 · Pick pieces one by one. Each of your pieces carries a +; pressing it adds that piece to the batch:

The + on each of your pieces. Real button, inert here.

As soon as the first one is in, a button appears in the wallet toolbar with the count. That is the one that opens the selection:

In the toolbar of your wallet, once something is selected

2 · Bulk manage a whole collection. With exactly one collection left in the wallet filter, a different button appears next to it:

Only visible with a single collection in the filter

It brings every piece you own from that collection — including the ones on pages you never scrolled to. That is the point: a selection is not limited to what happens to be on screen.

The drawer with your selection

Either way you end up here: a panel that opens on the right, listing what you have picked, with the count and the three ways out — go to the Bulk Manager, empty the selection, or just close it.

Bulk Selection
3 items
Zoide Nº 7 · #12 0.0250 ($0.43)
Zoide Nº 7 · #13 0.0250 ($0.43)
Zoide Nº 7 · #14
The selection drawer. The pieces listed are made up; the panel is the real one.

Up to 10,000 pieces in one batch.

The three actions

Action What it asks for Worth knowing
List One price, applied to every piece The same price for all of them. Different prices need different batches
Transfer A username or an ordinals address One destination for the whole batch
Delist Nothing Only the pieces that are actually listed are processed; the modal tells you how many that is

Each action is a button on the selection drawer, and each opens its own form — the one price, or the one destination. Those three buttons only exist inside your own selection, so they are not shown here.

For List, the one price you type is what every piece in the batch ends up showing:

0.0250 ($0.43)
The price applied to the whole batch, as it will appear on each piece

Anything in your selection that is not yours any more is skipped rather than failing the batch.

One batch at a time

While a batch is pending or running, starting another is refused. Wait for it, or stop it.

This is not a queueing limit for its own sake: batches spend your coins, and two batches spending the same coins at the same time is how transactions cancel each other out.

Watching it run

The jobs block appears below your selection, without leaving the page, and counts pieces processed out of the total. Your selection stays as it was.

The block stays after it finishes so you can read it — nothing disappears the moment it is done. When you clear it, the page re-reads the chain and refreshes your selection: anything you just transferred away appears greyed out and stops being actionable, because it is not yours to act on.

If part of it fails

The rest is not undone. Failed pieces are listed with their error; everything that worked stays done.

That is the honest behaviour for a batch of independent transactions: rolling back thirty-eight successful on-chain operations because two failed is not something anybody can do, so we do not pretend otherwise. Fix the two and run them again.