10 min read

Source: Roblox Creator Hub · CC BY 4.0 · View source · Code samples: MIT Imported 2026-10-03. Formatting adapted for this site.

Passes

Passes let you charge users a one-time Robux fee to access special privileges inside your game, such as entry to a restricted area, an in-game avatar item, or a permanent power-up.

Note

For items that a player might purchase multiple times, such as potions, temporary power-ups, or in-game currency, see Developer products.

Create a pass

Note

Before creating a pass, make sure your game has been published and is accessible on Roblox.

To create a pass:

1. Go to Creations and select a game.

2. Go to Monetization ⟩ Passes.

3. Click Create pass.

4. Upload an image to display as the pass icon. Make sure the image doesn't exceed 512x512 pixels, doesn't include important details outside of its circular boundaries, and is in .jpg, .png, or .bmp format.

5. Enter a name and a description for the pass.

6. Select a category for the pass. The category is used to organize items in your in-game Shop.

7. Click Create pass.

   

Note

Includes relevant content

<img alt="Bad circular trimming" src="https://prod.docsiteassets.roblox.com/assets/monetization/passes/Circular-Trimming-Bad.png" />

Note

Crops important content

Note

If you want to use the pass as a randomized reward, review the Randomized Virtual Item Policy.

Get the pass ID

To use scripting, you need a pass ID. To get the pass ID:

1. Go to Monetization ⟩ Passes.

2. Hover over a pass' thumbnail, click the ⋯ button, and select Copy Asset ID from the context menu.

   

Sell a pass

Note

Starting May 30, 2026, cross-game pass sales will be disabled. If your game relies on cross-game sales mechanics, we recommend integrating Robux transfers before this date to avoid service interruptions.

Note

If you're using price optimization, make sure the script runs on the client so that users see personalized pass prices.

You can sell passes in two ways:

• Inside your game
• Outside your game

Inside your game

To implement and sell a pass inside a game, call MarketplaceService functions.

Use GetProductInfo() to retrieve information about a pass, like name and price, and then to display that pass to users. You can sell the pass inside your game's marketplace, for example. For passes, the second parameter must be InfoType.GamePass.

local MarketplaceService = game:GetService("MarketplaceService")

-- Replace the placeholder ID with your pass ID
local productId = 000000

local success, productInfo = pcall(function()
	return MarketplaceService:GetProductInfo(productId, Enum.InfoType.GamePass)
end)


if success and productInfo then
	-- Check if product is for sale
	if productInfo.IsForSale then
	-- Display product information
	-- Replace the print statements with UI code to display the pass
  	print("Pass Name: " .. productInfo.Name)
  	print("Price in Robux: " .. productInfo.PriceInRobux)
  	print("Description: " .. productInfo.Description)
	else
		print("This product isn't for sale")
	end
end

Use PromptGamePassPurchase() to prompt a pass purchase if the user doesn't already have the pass in their inventory. You can call this function when a user performs actions like pressing a button or talking to a vendor NPC.

local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")

-- Replace the placeholder ID with your pass ID
local passID = 0000000

-- Prompt pass purchase
local function promptPurchase()
	local player = Players.LocalPlayer
	local hasPass = false

	local success, message = pcall(function()
		hasPass = MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
	end)

	if not success then
		warn("Error while checking if player has pass: " .. tostring(message))
		return
	end

	if hasPass then
		-- Show a message telling user they already own the pass
	else
		-- Prompt pass purchase
		MarketplaceService:PromptGamePassPurchase(player, passID)
	end
end

Use PromptGamePassPurchaseFinished to handle a completed pass prompt and purchase and assign the user the privileges associated with the pass.

Place the script inside the ServerScriptService so that the server handles the user's pass privileges.

local MarketplaceService = game:GetService("MarketplaceService")

-- Replace the placeholder ID with your pass ID
local passID = 0000000  -- Change this to your Pass ID

-- Handle a completed prompt and purchase
local function onPromptPurchaseFinished(player, purchasedPassID, purchaseSuccess)
	if purchaseSuccess and purchasedPassID == passID then
		print(player.Name .. " purchased the Pass with ID " .. passID)
		-- Assign the user the ability or bonus related to the pass
	end
end

-- Connect PromptGamePassPurchaseFinished events to the function
MarketplaceService.PromptGamePassPurchaseFinished:Connect(onPromptPurchaseFinished)

Note

Although Roblox itself does not record the purchase history of passes by specific users, you can request to download sales data. If you want to track user-specific purchase history, it's your responsibility to store the data.

Outside your game

To sell a pass on the Store tab of the game details page:

1. Go to Monetization ⟩ Passes.
2. Hover over the pass and click the ⋯ menu.
3. Select the pass you want to sell.
4. Select Sales.
5. Enable to Item for Sale toggle.
6. In the Price in Robux field, enter the amount of Robux you want to charge users for the pass. The price you enter affects how much Robux you earn per sale. The minimum price is 1 Robux, and the maximum price is 1 billion Robux.
7. Click Save Changes. The pass populates in the Store tab of the game details page.

Assign pass privileges

You must manually assign pass privileges to users that purchase your passes. To do this, use PlayerAdded when a user joins your game to check if they already own the pass and to assign them the pass privileges.

Place the script inside the ServerScriptService so that the server handles the user's pass privileges.

local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")

-- Replace the placeholder ID with your pass ID
local passID = 0000000

local function onPlayerAdded(player)
	local hasPass = false

	-- Check if user already owns the pass
	local success, message = pcall(function()
		hasPass = MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
	end)

	if not success then
		-- Issue a warning and exit the function
		warn("Error while checking if player has pass: " .. tostring(message))
		return
	end

	if hasPass then
		-- Assign user the ability or bonus related to the pass
		print(player.Name .. " owns the Pass with ID " .. passID)
	end
end

-- Connect PlayerAdded events to the function
Players.PlayerAdded:Connect(onPlayerAdded)

Personalize your in-game store

You can use product intelligence APIs to sort and recommend passes to users. Personalizing your in-game store helps surface the most relevant items to each user, boosting engagement and revenue. By tailoring passes to user preferences, you can improve their discovery, increase conversion rates, and unlock new monetization opportunities.

Rank passes for sale

RankProductsAsync takes in a list of product IDs and returns a personalized ordered list of those products. You can use this method to provide your users with personalized item recommendations in your in-game store.

Note

Because RankProductsAsync has a strict rate limit, you should load recommendations once at game join instead of calling it repeatedly.

Example: Three "Power" items ranked for the user

local MarketplaceService = game:GetService("MarketplaceService")

-- Create the array of products you want to rank
local productIdentifiers = {
    {InfoType = Enum.InfoType.GamePass, Id = 123},
    {InfoType = Enum.InfoType.Product, Id = 456},
    {InfoType = Enum.InfoType.Product, Id = 789}
}

-- Optional: Wrap the call in an async task so that if the request is slow,
-- it doesn’t freeze the UI / game
task.spawn(function()
    -- Use a pcall to handle errors gracefully
    local success, result = pcall(function()
        return MarketplaceService:RankProductsAsync(productIdentifiers)
    end)

    if not success then
        -- If failed, 'result' is the error message.
        warn("Failed to rank products:", result)
    end

    -- Load the returned items into the store.
    for i, rankedItem in ipairs(rankedProducts) do
        local productIdentifier = rankedItem.ProductIdentifier
        local productInfo = rankedItem.ProductInfo
        -- ...
        -- Logic to add productInfo into store
    end
end)

Display your top passes

Note

If your game has had no item sales in the past 28 days, RecommendTopProductsAsync returns an empty list. At least one purchase within the last 28 days is required for this API to generate recommendations.

RecommendTopProductsAsync takes an array of InfoType values and returns up to 50 items a user is most likely to engage with and purchase. You can use this method to create a "Top Picks" section in your in-game store.

If no recommendations can be determined, RecommendTopProductsAsync returns 0 items. Any passes that the user already owns are also not returned.

In rare cases, calls to the ranking model can be slow. To help prevent added lately for users, we recommend using task.spawn to make the call to RecommendTopProducts non-blocking.

Example: A "Top Picks" tab in an in-game store

local MarketplaceService = game:GetService("MarketplaceService")

-- Create an array of product types to include. In this case both game passes and developer products
local productTypes = {Enum.InfoType.GamePass, Enum.InfoType.Product}

-- Optional: Wrap the call in an async task so that if the request is slow,
-- it doesn’t freeze the UI / game
task.spawn(function()
    -- Use a pcall to handle errors gracefully
    local success, result = pcall(function()
        return MarketplaceService:RecommendTopProductsAsync(productTypes)
    end)

    if not success then
        -- If failed, 'result' is the error message.
        warn("Failed to rank products:", result)
    end

    -- Load the returned items into the store. Make sure to filter out any 
    -- ineligible items from topRankedItems such as developer products the
    -- user can no longer purchase
    for i, rankedItem in ipairs(rankedProducts) do
        local productIdentifier = rankedItem.ProductIdentifier
        local productInfo = rankedItem.ProductInfo
        -- ...
        -- Logic to add productInfo into store
    end
end)

Promote a pass

Note

Promoted passes are given to users for free.

To help more users discover your game, you can opt-in to have your passes featured on Roblox's Buy Robux page. Opting-in to promote your passes can help increase the time and Robux users spend in your game. There is no limit to the number of passes you can promote.

Users are shown passes that are relevant to their play history and engagement on the platform. They are not shown passes that they already own.

When users purchase an eligible Robux package, they receive the promoted pass and are prompted to claim their pass by joining your game.

Note

For best results, we recommend that you create a unique pass specifically for the Buy Robux page.

To opt-in to promote one of your passes:

1. Go to Monetization ⟩ Passes.
2. Select the pass you want to promote.
3. Select Promotions.
4. Enable Include this item in the bonus pool.
5. Click Save Changes. The pass is shown to relevant users in the Buy Robux page.

The promoted pass:

• Can be off-sale or on-sale. If they're on-sale, their Robux value must be greater than 49 Robux and less than 801 Robux.
• Must include a thumbnail.
• Cannot grant paid random items.
• Must comply with the Community Standards.

Pass analytics

Use pass analytics to analyze the success of individual passes, identify trends, and forecast potential future earnings.

With analytics, you can:

• View your top passes over a selected time period.
• Showcase up to eight top-selling items on a time-series graph to analyze overall sales and net revenue.
• Monitor your catalog and sort items by sales and net revenue.
• View how many passes were acquired by users through promotion on the Buy Robux page.
• View how many users joined your game after acquiring the pass through the Buy Robux page.

To access pass analytics:

1. Go to Creations and select a game.
2. Go to Monetization ⟩ Passes.
3. Select the Analytics tab.