Master Edition Plugin

The Master Edition Plugin groups numbered edition Assets under a Collection. Store maximum supply, edition names, and URIs to create print series like "Limited to 100 copies."

Summary

The Master Edition plugin is an Authority Managed plugin for Collections that groups Edition Assets together. Store the maximum supply and optional edition-specific metadata.

• Authority Managed (update authority controls)
• Works with Collections only (not Assets)
• Values are informational, not enforced
• Use with Candy Machine for automatic edition creation

Out of Scope

Supply enforcement (use Candy Machine guards), individual edition numbers (use Edition plugin on Assets), and automatic minting.

Quick Start

Jump to: Create Collection · Update Plugin

1. Create Collection with Master Edition plugin and max supply
2. Mint Assets with Edition plugin (numbers 1, 2, 3...)
3. Update max supply or metadata as needed

Works With

Arguments

Creating a Collection with the Master Edition plugin

import { generateSigner, publicKey } from '@metaplex-foundation/umi'
import { createCollection } from '@metaplex-foundation/core'
const collectionSigner = generateSigner(umi)
await createCollection(umi, {
  collection: collectionSigner,
  name: 'My NFT',
  uri: 'https://example.com/my-nft.json',
  plugins: [
    {
      type: 'MasterEdition',
      maxSupply: 100,
      name: 'My Master Edition',
      uri: 'https://example.com/my-master-edition.json',
    },
  ],
}).sendAndConfirm(umi)

Update the Master Edition Plugin

If the Master Edition Plugin is mutable it can be updated similar to other Collection Plugins:

import { publicKey } from '@metaplex-foundation/umi'
import { updatePluginV1, createPlugin } from '@metaplex-foundation/mpl-core'
const asset = publicKey('11111111111111111111111111111111')
await updatePlugin(umi, {
  asset: asset,
  plugin: {
    type: 'MasterEdition',
    maxSupply: 110,
    name: 'My Master Edition',
    uri: 'https://example.com/my-master-edition',
  },
}).sendAndConfirm(umi)

Common Errors

Cannot add to Asset

Master Edition only works with Collections, not individual Assets. Use the Edition plugin for Assets.

Authority mismatch

Only the update authority can add or update the Master Edition plugin.

Notes

• All values (maxSupply, name, uri) are informational only—not enforced
• Use Candy Machine guards to enforce actual supply limits
• The name/uri override Collection metadata for edition-specific branding
• Can be updated at any time by the authority

Quick Reference

Arguments

Edition Setup Pattern

FAQ

Does Master Edition enforce the max supply?

No. The maxSupply is informational only. Use Candy Machine with appropriate guards to actually enforce supply limits during minting.

What's the difference between Master Edition name/uri and Collection name/uri?

Master Edition name/uri can provide edition-specific metadata that differs from the base Collection. For example, a Collection might be "Abstract Art Series" while the Master Edition name could be "Limited Print Run 2024."

Can I create open editions (unlimited supply)?

Yes. Set maxSupply to null or omit it entirely. This indicates an open edition with no defined limit.

Do I need both Master Edition and Edition plugins?

For proper print tracking, yes. Master Edition goes on the Collection (grouping and supply info), Edition goes on each Asset (individual numbers). They work together.

Can I add Master Edition to an existing Collection?

Yes, unlike the Edition plugin on Assets, Master Edition can be added to existing Collections using addCollectionPlugin.

Glossary