Skip to main content

Gumball

Gumball Banner

Create randomized artwork distribution where collectors never know which piece they'll receive until after purchase, building excitement and discovery.

What is Gumball?​

Gumball is a tool created by mallow that lets you sell minted artworks through a virtual gumball machine. You can set up a solo gumball machine or team up with others for a collaborative one. The machine allows you to sell either your own creations, or other artists' - whether that's primary or secondary sale. When buyers collect from the gumball machine, they will receive a random artwork from the prize pool.

Key Features​

🎯 Random Distribution​

Each purchase draws a random artwork from the loaded artworks.

👥 Collaboration Support​

Invite collaborators to contribute artworks to your Gumball, with automatic revenue sharing.

🎫 Allowlist Phases​

Create up to 4 exclusive sale phases with custom pricing and access controls before public launch.

💎 Flexible Pricing​

Support for SOL, USDC, and other SPL tokens with different prices per phase.

🎁 Physical Rewards​

Optionally include physical items or experiences as rewards for buyers.

📊 Gumball Studio​

Track sales, revenue, and performance metrics in real-time.

Sales Configuration​

Gumball Details​

Name​

  • Enter a title for your Gumball sale (32 character limit)
  • This appears on the Gumball page and Explore page cards

Description​

  • Add an optional description explaining your Gumball sale (1000 character limit)
  • Help collectors understand the concept and artworks included

Thumbnail​

  • Upload a cover image representing your Gumball sale
  • Recommended size: 690px (w) x 920px (h)
  • Supported formats: .jpeg, .gif, .webp, .png (10mb max)

Categories and Tags​

  • Select relevant categories to improve discoverability
  • Add custom tags to help collectors find your work
  • Tags also determine automatic categorization

Physical Artwork​

  • Include physical artwork with sale - Check this if you're selling a physical piece along with each sale.
    • Describe any pertinent shipping details the collector should know about
    • Optionally upload a photo of the physical piece to show collectors what they're getting
  • Ask buyer for shipping address - Check this if you want collectors to send you their shipping address through mallow.

Rewards​

If you want to reward buyers with something special, let them know here!

Supported Artworks​

  • Both Metaplex Core and Legacy 1/1's are supported
  • Maximum items per Gumball: 1000
  • Choose to invite others to submit artworks or sell solo

Pricing​

  • Set a specific price for the buyer
  • Currency options: SOL, USDC, or other supported tokens
  • Minimum: 0.01 SOL or equivalent

Curator Fees (Collaborative Gumballs)​

  • Curator Fee: % of each sale (optionally set by curator)
  • Proceeds automatically sent to artwork creators

Wallet limit​

Optionally set a specific limit of how many editions each wallet can purchase

Start Time​

  • Start manually: Launch when you're ready
  • Scheduled start: Set a specific date and time for automatic launch
  • All times displayed in your local timezone

Allowlist Phases​

Setup Requirements​

  • Requires a scheduled start time
  • Maximum of 4 allowlist phases before public sale

Phase Configuration​

Each allowlist phase includes:

  • Phase name: Descriptive title for the presale
  • Duration: How long the phase will last for. A phase always starts when the previous one ends.
  • Pricing: Can differ from public price
  • Wallet allowlist: CSV or JSON upload of eligible addresses

Getting Started​

Step 1: Create Your Gumball​

  1. Navigate to Create → Gumball
  2. Set your machine's name, description, and cover image
  3. Choose your pricing structure and payment token
  4. Configure sale timing and wallet limits

Step 2: Configure Collaborators (Optional)​

If you want to create a collaborative Gumball:

  1. Set the maximum number of collaborators
  2. Define an optional curator fee
  3. Send collaboration invites to other artists
  4. Wait for artists to submit their artworks

Step 3: Set Up Allowlist Phases (Optional)​

Create exclusive presale phases:

  1. Phase Name: Give each phase a descriptive name
  2. Duration: Set start and end times
  3. Price: Set phase-specific pricing
  4. Allowlist: Upload CSV/JSON of eligible wallet addresses

Step 4: Load Artworks​

Solo Gumball:

  • Upload pre-minted artworks directly through the interface. Use the minting tool if you don't have your artworks minted yet.
  • Each artwork becomes one "gumball" in your machine

Collaborative Gumball:

  • Review submitted artworks from collaborators
  • Accept or decline submissions

Step 5: Launch Your Sale​

  1. Review all settings and loaded artworks
  2. Start sales when ready
  3. Monitor performance through the Gumball Studio

Step 6: Ending Your Sale​

  1. Sales automatically end once all Gumballs are sold
  2. You can end the sale at any point (once ended Gumballs cannot be re-started!)
  3. Once ended, proceeds and any remaining artworks can be claimed
  4. Once proceeds are claimed, close your Gumball to receive your SOL rent paid when creating

Ready to create your first Gumball Machine? Head to the Create page to get started!