This article will walk you through the necessary steps to build, submit, and activate your content on the Roll20 Marketplace and on Supported Marketplaces like DriveThruRPG and DMsGuild.
We recommend reviewing the Item Management Page article first before digging into this one.
If you have not yet applied for your Roll20 Marketplace Partner account, please follow the instructions found here.
Roll20 and Supported Marketplaces
You are able to create Roll20 products to be sold on the Roll20 Marketplace, DriveThru Marketplaces, and through Community Content Program sites like DMsGuild and Pathfinder Infinite. A linking process will unlock content on Roll20 for users who make purchases from Supported Marketplaces.
The main thing to consider when selecting an option from the following is where the item will be for sale:
- Roll20 Marketplace and DriveThru Marketplaces content includes titles that are listed for sale on Roll20's Marketplace and titles that can be linked to a listing for sale on supported marketplaces like DriveThruRPG through a UUID (Universally Unique ID).
- Supported Marketplace ONLY Content cannot be listed for sale on Roll20's Marketplace but will unlock content on Roll20 for users who make purchases from Supported Marketplaces via a UUID (Universally Unique ID). Community Content Programs such as DMsGuild, Pathfinder Infinite, and Miskatonic Repository fall under this category.
Creating Items
To begin you will need to be on your Item Management Page to create a new Item Listing.
Step 1: Click the CREATE NEW ITEM button.
Step 2: A two-page modal window will pop up where you can set where this new Item will be sold.
NOTE: This selection cannot be changed after you leave this window; if you select the wrong option, you will have to make a new listing.
The options available are:
- Roll20 Marketplace: This Item will be listed for sale on Roll20's Marketplace and can be linked to a listing on DriveThru Marketplaces.
- Supported Marketplace ONLY: These items will not be listed for sale on Roll20's Marketplace, but will unlock content on Roll20 for users who make purchases from the Supported Marketplaces. Community Content Programs such as DMsGuild, Pathfinder Infinite, and Miskatonic Repository fall under this category.
Click the CONTINUE button to move to the second page of the modal window after choosing your desired marketplace.
Step 3: Next, set the Item's Title and Item Type.
- Set the Title of your Marketplace Item. (This can be edited later.)
- Select the Marketplace Item Type your new Item will be from the provided dropdown menu. (This cannot be edited later.)
- 🎨Art Pack: Maps, tokens, objects, etc.
- 💖Token Marker Set: Small token-overlay icons to track statuses, conditions, etc.
- ➕Game Addon: Short/one-shot Adventures, Rule Expansions, Card Decks, or other enhancements that customers can add to existing games.
- 🌄Game Module: Self-contained Adventures, Board & Card Games, or entire Rulebook Systems. Customers CANNOT add these to existing games.
- 🎁Package: A single-purchase collection of sub-items that are not for sale individually.
- 🎁Dynamic Bundle: A collection of existing sub-items that are for sale individually and may be discounted up to 30%. Customers only pay for items in the Bundle they don't already own. Not available for Supported Marketplace ONLY items.
Click the CONTINUE button once you have the Title and Item Type set to finish creating the Item.
This will add the newly created listing to the bottom of your Draft list.
Building/Editing Your Item Listing
You can start setting up your new Marketplace item by clicking on its Title on the Draft tab. This will display the Marketplace Listing for this item. This is the view that will be seen by customers on the Roll20 Marketplace once the listing has been Activated.
Every Item Type has the following editable fields:
Preview Image Carousel
This field can display up to seven images to help visually advertise your content. You can use JPG, PNG, GIF, or WEBM file types. The first image on the left of the carousel will always be treated as your item's Cover Image (and vice-versa). This image will be prominently displayed when your product is seen by customers while browsing the Marketplace. Image dimensions for a Cover Image are always 512 pixels wide by 512 pixels high, but all other preview images can be square or rectangular as desired. If your image is not 512 px wide by 512 px high when you upload it as your listing's cover image, the Marketplace will add blurred borders to the sides or top to prevent image distortion.
Upload your Cover Image first before any other promotional images you want to include in the Carousel.
Making the Most of Your Cover Image
Your Cover Image will be what draws Customers to click and review your product.
This image should feature:
- The name of the product
- Your company name/branding/logo
- An example of your artwork when selling an Art Pack/Token Marker Set or an eye-catching graphic for Addons/Modules/Packages/Bundles.
Marketplace Item Properties
Clicking on the EDIT ITEM PROPERTIES button will reveal the listing's properties.
Every Item Type has the following property fields:
- Title: The Title of your Item
- Cost: The price for the Item in USD. What you set here must follow our Marketplace Pricing Standards. This option will not be available to you if you selected "Supported Marketplace ONLY" as you will be selling the item exclusively on a different site. If you selected "Roll20 Marketplace and Supported Marketplaces," you must follow the pricing standards, but you are not obligated to maintain that price on your supported marketplace listing.
- "For Sale?" Toggle: This is a Yes/No dropdown menu that will enable a customer to buy this item. This is set to "Yes" by default. The only times you would set this to "No" is when the item is meant to be part of a larger Package and not to be sold separately or when you wish to remove the item from being purchasable. This option will not be available to you if you selected "Supported Marketplace ONLY."
-
Description: This is the body text that will advertise your product. This field uses Markdown syntax to format the text here. We recommend using Markdown Live Preview if you would like to see an instant preview of what your text will format as.
- You can also add Strikethroughs and Embedded Images to your Roll20 Market Item descriptions using Markdown!
To cross out text, nest the word/words between two tildes:~~Cross out this text~~
To add an image in Roll20 Market descriptions, use this formatting:
You can use a URL from an image hosting site or pull the URL for your image from within your Roll20 Tabletop Art Library.
- FOR ACCESSIBILITY REASONS, PLEASE DO NOT MAKE MULTIPLE LINKS COMPRISED OF THE EXACT SAME TEXT!
- You can also add Strikethroughs and Embedded Images to your Roll20 Market Item descriptions using Markdown!
- Item Category: This determines what Marketplace category to sort your Item under on the Marketplace.
- Secondary Filters: These are specific search filters that are specified by the Item's Category. Some of these fields are required and you can also add more as needed.
- Item Tags: Up to 5 unique tags can be added to an Item to help with Marketplace searchability. Product Name, Publisher Name, Game System, and other secondary filters are already accounted for. Do not use hashtags(#) in tag names. You will also want to hit the Return key between tags so you do not end up with one giant tag.
For more information on how to properly assign the right Item Categories, Secondary Search Filters, and Tags for your Item please review the following articles:
Other specific property fields exclusive to a given Item Type will be called out in the next section.
Remember to click on the SAVE CHANGES button to keep any edits to your Item Properties.
A Note About Supported Marketplace Item Properties
Items that have been created as Supported Marketplace ONLY products will have fewer required fields. For instance, the List Price will be set to "0.0" by default as well as the For Sale? option set to "No." The Cover image (i.e. the listing's "Avatar") will still need an image uploaded to it as well as its Item Category and required Secondary Filters. Any required elements will be noted in red on the Draft tab of the Item Management page.
Setting Up Listings by their Item Type
Step 1. Create a New Art Pack Item
Make sure you have chosen the "Art Pack" Item Type when you create your new Item Listing.
"Token Set" Confusion
You will note that your Art Pack Item Listing will display as a "Token Set" on the Item Management Page regardless of what sort of artwork you are uploading. This is expected behavior and understandably confusing. The term "Token" in Roll20's Code is used for any image object that can be dropped down on the Tabletop. What determines where your Art Pack will be categorized under on the Marketplace is its Item Category under Item Listing Properties.
Step 2. Set Up Your Item Properties
- It's very important for Art Packs that you set the "Is this set to be sold via the Roll20 EULA / available for purchaser download?" toggle correctly. This property dictates whether your Art Pack can be downloaded by the Customer. This is set to "Yes" by default.
- Your Item Category dictates where your Art Pack will be sorted under. Review the Item Type and Category article to become familiar with them.
- Pay special attention to the Genre, Art Style, Perspective, and Grid Secondary Filters for better searchability.
- Set the "Grid" Filter to "None" if your artwork does NOT have a grid drawn on it.
- Manually add additional Grid and Perspective Filters if your artwork includes assets that use different perspectives or have grid and non-gridded versions of maps.
Step 3. Upload Your Art
- Art Packs have a counter of how many assets are included in the Pack. It will read as "0 Items Included in [Item Name]" by default.
- Right below this text are three buttons: EDIT ALL IMAGES, UPLOAD IMAGES, and CANCEL UPLOAD
- Click on the UPLOAD IMAGES button and an image upload dropbox window will appear. Drag and drop batches of your art assets from your File System to here. Thumbnail previews of all the images you add to this dropbox will process briefly and you'll have the opportunity to add more or delete images before the upload process starts.
- Under the upload dropbox is the Set Grid Dimensions section that can automatically detect your art's grid size during the upload process. This automation tool is currently only available for square grids. In the Grid Cell Width field, enter the number of pixels wide one grid cell unit on your artwork takes up. (No height value is needed since height should match width for square grids.)
- Take a look at our Image Dimensions, Resolution, and File Type Specifications article for recommendations regarding pixel-scale-per-grid-cell for different kinds of assets.
- Leave this field blank if your art is intended for non-square grids or if you do not want the dimension automation to occur. The assets will upload to the default 1 unit wide by 1 unit high, which you can manually adjust once the upload has processed.
- Click on the SAVE CHANGES button to start the Upload process.
- A new modal window labeled "Edit Image Properties" will appear and display the progress of your image upload. You will not be able to edit the Item Listing until the upload process has finished. You can also cancel the upload process here using the "Cancel Upload" button!
Uploads Can Take a While!
Uploads of especially large files and/or large batches of files can take a long time to complete. You can tab out or close the browser tab altogether and the upload process will still continue in the background while you wait.
We have found that very high resolution files can crash the uploader on occasion. If it appears that the uploader is stuck for more than 1 hour, cancel the upload from the page listing or the Upload window using one of the "Cancel Upload" button!
- The Edit Image Properties window will be accessible once the upload has been completed and will allow you to edit all the images that were just added to the Art Pack. Read more about Edit Image Properties options below the screenshot.
- Here you can adjust the name of the image, add three unique tags, and manually set its grid width and height. If you used the Set Grid Dimensions automation, the grid width and height should be automatically set based on the pixel width chosen for a grid unit and the full dimensions of the art asset.
- If the dimensions don't divide evenly, the Grid Size Parser will round to the nearest whole grid unit.
- No dimension can be larger than 99 grid units. The Grid Size Parser will adjust the other dimension to be proportional to the 99-unit cap.
- We highly recommend setting grid dimensions for Battle Map, Tile Set, and Token assets. This setting affects how the Tabletop sizes the image when it is dragged from a customer's Art Library to the Tabletop. If you leave this at the default 1x1, the customer has to do more work to adjust the asset. Click on the Save Changes button to save your edits.
- Batch Edit Options for Select All, Deselect All, Delete Selected Images, and Setting Dimensions for Selected Images are available. You can select individual images to adjust by utilizing the checkboxes on the lefthand side of the window.
- Here you can adjust the name of the image, add three unique tags, and manually set its grid width and height. If you used the Set Grid Dimensions automation, the grid width and height should be automatically set based on the pixel width chosen for a grid unit and the full dimensions of the art asset.
- You can return to the Edit Image Properties window again by clicking on the pencil icon on any uploaded asset in the Art Pack or clicking on the EDIT ALL IMAGES Button.
Step 1. Create a Custom Token Marker Set on Your Marketplace Account
Creating a Token Marker Set works differently from Art Packs. You will not be uploading your images directly to the Item Listing. You will instead need to create a Custom Token Marker Set outside of the Item Management Page altogether and add your images there.
Follow the instructions from the Custom Token Marker Sets article if you have never made one before. Make sure this is done on the same Roll20 account that owns your Marketplace storefront.
Note: No tags are required on individual Token Marker images. You will want to include a short and descriptive name for each image so they will be easier to search for and be called by API scripts.
Step 2. Create a New Token Marker Marketplace Item
Make sure you have chosen the "Token Marker Set" Item Type when you create your new Item Listing.
Step 3. Edit Your Item Properties
There is a unique dropdown menu that is displayed directly below the "For Sale?" toggle. The field is labeled as "Source Token Marker Set:" and this is where you choose the Custom Token Marker Set you created in Step 1.
Please make sure to include the following Item Category and Secondary Filter Properties
- Item Category: Art -> Token Markers
- Installation: Token Marker
- Downloadable: Yes
The main difference between Game Addons and Game Modules is how your content is installed to a customer's game. You will want to set the "Installation" Secondary Filter to "Addon" or "Module" respectively based on what product you're listing.
The unique field to look for when editing Item Properties of an Addon or Module is the "Base Campaign" field. It is located directly below the "For Sale?" field. This is where you input the Game ID number of the Roll20 Game you will be using as the template for your Addon or Module.
You can find your Game's ID Number by first navigating to its Game Details Page. Look at its URL. It will appear as https://app.roll20.net/campaigns/details/XXXXXXXX/your-game-name. The sequence of numbers between the "details" and the game's name portions of the URL is your Game ID Number. This is what you will input in the Base Campaign field of your Item Listing.
You'll know when you have linked to your game correctly after saving your Item Properties. Under the "EDIT ITEM PROPERTIES" Button your game will now have a hyperlink to your game's Game's Details Page beside the "Base campaign" field.
The "Create Game with Module/Addon" Button Will Not Work Yet
The CREATE GAME WITH MODULE/ADDON button will only work AFTER the Item Listing has been Approved by Roll20 Staff. The approval process is when Roll20 copies your game over to the Marketplace. Once your base game has a modulize/addonize success message on it, navigate to your item listing and press "CREATE GAME WITH MODULE/ADDON" button to test if everything copied over successfully.
If there are any errors, you must submit a support ticket.
Building Packages and Bundle Item Listings work very similarly.
Adding Marketplace Listings
On the Item Page, there is a dropdown menu to select from all the items listings linked to your account. It will be labeled "This Bundle Includes:" or "This Package Includes:" depending on which you have selected.
After selecting one of your listings click on the "ADD ITEM" Button to add it to this Item Listing. The new sub-item will then appear above the dropdown menu. There is no limit to the number of items you can include in a Package or Discount Bundle.
Make Sure your Sub-Items Are Active
You can include sub-items to a Package or Discount Bundle that are not currently Active. This functionality allows you to prepare a multi-item Product before its release date. Once you're ready to go live, make sure all your sub-item listings have been Approved and Activated before you Activate your overall Package/Bundle. Customers will not have access to the sub-items until they are all activated.
If you include an item by mistake, you can simply click on the "Remove from Package" hyperlink that appears in red above each sub-item. If you want to add another sub-item to your Package or Bundle, you must send the Package or Bundle back to Draft to do so.
Supported Marketplace Warning for Dynamic Bundles
The price of Dynamic Bundles cross-listed to Supported Marketplaces is determined by the price set on the Supported Marketplace only. If a user purchases a Roll20 listing that includes a Roll20 Dynamic Bundle on a Supported Marketplace and they already own a sub-item in that Bundle on Roll20, they will not receive their additional dynamic discount at checkout. The Dynamic Bundle Item Type is not available for Supported Marketplace ONLY products.
Setting the Bundle Discount
When editing the Item Properties of a Discount Bundle you will see some additional fields by the "Cost:" field:
The Dynamic Cost is the automated sum of all the sub-items prices together. This field is not editable.
The "Bundle Discount %:" is where you set the percentage to discount your products. The maximum allowed discount for any Discount Bundle is 30%, but you can use smaller percentages.
The Cost and Discount fields dynamically affect each other and will auto-calculate their values if you change one of these fields.
Discount Bundles are the only Marketplace Items that do not have to have a Cost value that uses the $0.49 or $0.99 USD cent price increments.
Review Your Active Discount Bundle While Logged Out
You will want to be logged out of your Roll20 account to review your Discount Bundle after it has been activated to ensure its discount is displaying correctly. A Partner automatically owns all the content they release on the Marketplace and this will cause the Item Page of the Discount Bundle to not display the discount price from a customer's perspective while logged in.
Lastly, you will want to add a special Secondary Filter to any Discount Bundle Items. Click the dropdown menu beside the "ADD FILTER" button and select "Unique Status". Click on the ADD FILTER button to add this new Secondary Filter to your list. You will want to set the "Unique Status" filter to "Bundle". This will force the product to be correctly listed under the Bundle category of the Marketplace.
Submitting Items for Approval
Your item is ready for submission once you have added all aspects of your product and filled in all the necessary information to your Item Page.
The SUBMIT FOR APPROVAL button will be clickable on the DRAFTS tab. Clicking on this button will move your Item from the Draft tab to your Pending Tab. This status means that your Item has been added to the queue for Roll20 Staff to review.
You will be notified of any vital information or settings that need correcting on the right side of the Item Listing in red font. The SUBMIT FOR APPROVAL button will be disabled until these noted issues are corrected.
Content Approvals are processed daily Monday-Friday. All items submitted before 10 AM PT on a given day will be addressed by the next business day.
*NOTE: This schedule is subject to flex on rare occasions due to the observance of holidays and/or staff availability, or extreme fluctuations in the volume of submissions.
- If your content is approved, it will appear in the Approved tab of your Item Management page. Check the History of the item for any feedback. You can also see the item's UUID here.
- If your content is not approved, it will appear back in your Draft tab with a brief note describing the changes needed.
You can read more about the Approval Process here.
Activating Your Item
You will find your Item Listing on the Approved tab of the ITEM MANAGEMENT page after Roll20 has approved it.
Click the ACTIVATE button when you are ready for it to go live on the Marketplace.
You Choose When to Activate Your Item
You MUST click on this button for your item to go live. The Roll20 Team will not automatically publish it.
Linking Roll20 Content to Other Marketplaces
The following is a guide on how to list your Roll20 Items on Marketplaces such as DriveThruRPG or Community Content Program sites such as DMsGuild.
Dynamic Bundle Warning
The price of Dynamic Bundles cross-listed to Supported Marketplaces is determined by the price set on the Supported Marketplace only. If a user purchases a Roll20 listing that includes a Roll20 Dynamic Bundle on a Supported Marketplace and they already own a sub-item in that bundle on Roll20, they will not receive their additional dynamic discount at checkout.
Your Roll20 Product's UUID
Submitting content intended for any Supported Marketplace behaves the same.
Once the item is approved, you will see the UUID generated by navigating to the Approved tab. This sequence of letters and numbers is what you will need to include on your listing on the Supported Marketplace.
Click the ACTIVATE button when your item is ready to be publicly available.
If this is a Supported Marketplace ONLY product, a new modal window will pop up that will explain what is about to happen when activating this type of product.
The text of the popup reads as follows:
Activating this item will move it to the "Active-Supported" tab of your Item Management page. This item will be active but not searchable on the Roll20 Marketplace, and it can only be purchased via a Supported Marketplace such as DMsGuild, Pathfinder Infinite, etc.
Click on the ACTIVATE button when you're ready to activate the item.
This modal window will now display your UUID again.
You can always retrieve this UUID again at any time from the Item Management Page under the Active or Active-Supported tab.
Adding the UUID to a Supported Marketplace Listing
We will be using the DMsGuild as our example for screenshots and instructions, but the process is the same for all DriveThru sites.
Step 1: Listing Creation
You will need to create a NEW title for your Roll20 item even if you have an existing digital PDF or Print-on-Demand title on your Supported Marketplace. Utilize the Bundle feature if you wish to include your Roll20 product as part of a larger group purchase.
Step 2: Linking the UUID for your Roll20 Product
There is a section available when editing a new title labeled Virtual Table Top Connection shown in the screenshot below:
For Roll20 Content you'll want to make sure that the "Roll20" choice is selected.
The UUID (Universally Unique ID) that you generated for your Roll20 item is what you will paste into the Item UUID field here.
Once your settings are saved, the product page will look similar to the screenshot below with the Roll20 VTT item tag displayed under the listing's Title and Author.
Step 3: Approval and Activation
The submission for approval and activation process follows the same procedure as other digital DriveThru Marketplace product listings on their respective Marketplaces. The only nuance is that the Roll20 UUID will be needed to be added to the listing to sell its VTT content.
Customers who want to purchase these Roll20 items will be required to include the email address attached to their Roll20 account. The Roll20 product will then be listed on their My Marketplace Items page over on Roll20 after the purchase is processed.