Skip to main content

Releasing with Verse

There are three ways to integrate with Verse for primary sales, depending on how much control you need.

If you are deciding the release setup without API details, use For Artists & Galleries. If you are implementing a custom frontend, use For Developers and Release & Sales Mapping.

info

All integration types require you to create and manage collections, artworks, and sale listings via studio.verse.works. Managing these via the API is not available at the moment.

1. Release on verse.works

Zero technical work required. Everything happens on Verse — you set up your project in the studio, and share the sale link with collectors.

Best for: Artists, galleries, and creators who don't need a custom website.

How it works:

  1. Create your collection and artwork in studio.verse.works
  2. Deploy a smart contract
  3. Configure your sale (pricing, schedule, mechanics)
  4. Share your verse.works/series/your-slug link with collectors
  5. Collectors purchase directly on verse.works

No code, no hosting, no integration work.

2. Verse Frame

Easy integration. Embed Verse's sales UI into your own website. The purchase flow — including payment, minting, and wallet connection — happens directly on your site inside an iframe.

Best for: Galleries, artist portfolios, event pages that want their own website but don't need a custom purchase UI.

Steps:

  1. Set up your collection and sale in the studio
  2. Add the Verse Frame script to your site
  3. Place a <div> with the collection slug where the sale should appear
  4. Request origin allowlisting from the Verse team (required for production only — the sandbox needs no allowlisting)
<div verse-series-slug="your-collection-slug"></div>

<script>
const embed = new VerseEmbed({ baseUrl: "https://iframe.verse.works" });
embed.initialize();
</script>

See Verse Frame docs for full setup, customization, and responsive behavior.

3. Verse API + Verse Elements

Full control. Build your own UI using the GraphQL API for public data (collections, artworks, prices, stats) and Verse Elements for authenticated actions (sign-in, purchase dialogs, reserve checks).

Best for: Custom storefronts, branded experiences, projects with custom purchase flows.

Steps:

  1. Set up your collection and sale in the studio
  2. Query the GraphQL API for artwork and pricing data
  3. Build your own UI to display collections and artworks
  4. Use Verse Elements for authentication and purchase dialogs
  5. Optionally check reserves and eligibility before showing the purchase UI

See the Verse Elements Integration Guide for a full walkthrough.

Choosing the Right Approach

RequirementRecommended
No development workverse.works
Own website, minimal codeVerse Frame
Custom UI and brandingAPI + Elements
Custom purchase flowAPI + Elements
Access-controlled salesAPI + Elements

End-to-End Timeline

Regardless of integration type, a typical release follows the same workflow:

  1. Plan — Choose project type, sale mechanics, and contract type
  2. Create — Set up collection and artwork in studio.verse.works
  3. Test — Use the sandbox environment to validate everything
  4. Deploy contract — Deploy your smart contract on mainnet
  5. Configure sale — Set pricing, schedule, and reserves in the studio
  6. Launch — Share your link or go live with your integration