8 min read

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

Player invite prompts

In addition to common promotion methods for increasing your player base, you can implement invite prompts directly inside your game, encouraging players to invite their friends and increase co-experience gameplay.

The invite prompt system features the following:

• Dynamic Invitees — Prompt players to invite multiple friends from a selection list, or invite one specific friend.
• Launch Data — Include optional launch data that can be read through Player:GetJoinData() when the invited friend joins. Example use cases include routing invited friends to a coordinate location or personalizing the joining game for the invitee.
• Customizable Text — Customize the invite prompt message and the notification message. For example, an invite prompt for the player may read "Ask your friends to join the adventure!" and the notification message for the invited friend(s) may read "{displayName} wants you to join their adventure in {experienceName}!".

You can also track and reward inviters and invitees using the Friend Invite Reward System.

In-experience prompt

 <img src="https://prod.docsiteassets.roblox.com/assets/promotion/invite-prompts/Invite-From-Experience.png" width="840" height="403" />

Invite notification

  <img src="https://prod.docsiteassets.roblox.com/assets/promotion/invite-prompts/Invite-App-Notification-Stream.png" width="403" height="403" />

  <img src="https://prod.docsiteassets.roblox.com/assets/promotion/invite-prompts/Invite-Phone-Lock-Screen.png" width="403" height="403" />

Set invite options

By default, an invite prompt for the player shows a menu of their friends with Invite buttons. To customize the prompt message, target a specific friend, or include launch data in the invite, you'll need to set up an ExperienceInviteOptions object with the desired properties.

Multiple friends

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

local player = Players.LocalPlayer

-- Construct invite options with a custom prompt message
local inviteOptions = Instance.new("ExperienceInviteOptions")
inviteOptions.PromptMessage = "Ask your friends to join the adventure!"

Specific friend

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

local player = Players.LocalPlayer
local receiverUserID = 505306092

-- Construct invite options with friend's user ID and a custom prompt message
local inviteOptions = Instance.new("ExperienceInviteOptions")
inviteOptions.InviteUser = receiverUserID
inviteOptions.PromptMessage = "Invite this friend to join the adventure!"

Set notification options

By default, the invite notification that friends receive contains the sender's DisplayName, username, and the game name. To customize the message, you can create a Notification asset on the Creator Dashboard and include its asset ID as a parameter of ExperienceInviteOptions.

1. Navigate to the Creator Dashboard.

2. Similar to badges, notification strings are tied to a specific game. Locate that game's thumbnail and click on it.

3. In the left column, under Engagement, click Notifications.

4. In the center region, click the Create a Notification String button.

5. Fill in an identifier name (only visible to you) and the custom notification text. Note that you must include {experienceName} as a placeholder to identify the game's name for invited friends, and you can optionally include the sender's DisplayName through the {displayName} placeholder.

   Example notification strings:

   {displayName} wants you to join their adventure in {experienceName}!

   {displayName} just cleared the sixth stage of {experienceName}. Can you?

6. When ready, click the Create Notification String button.

7. On the notifications page, in the table of notifications, click the ⋯ button in the Actions column and select Copy Asset ID.

8. In the ExperienceInviteOptions object for the invite prompt, paste the asset ID as the value of the InviteMessageId property.

   local SocialService = game:GetService("SocialService")
   local Players = game:GetService("Players")
   
   local player = Players.LocalPlayer
   
   -- Construct invite options with friend's user ID
   local inviteOptions = Instance.new("ExperienceInviteOptions")
   inviteOptions.InviteMessageId = "ef0e0790-e2e8-4441-9a32-93f3a5783bf1"

Prompt an invite

To prompt an invite, you should first determine whether the player can send an invite, as the ability may vary depending on the platform or player. Once confirmed, you can display the invitation prompt to the player.

1. Call SocialService:CanSendGameInviteAsync(), wrapped in a LuaGlobals.pcall() since it's an asynchronous network call that may occasionally fail.
2. If the invite ability is confirmed, call SocialService:PromptGameInvite() with the optional invite options object as the second argument.

Once prompted, the player will see an on-screen prompt to invite multiple friends, or the specific friend defined in the invite options object. When the player then clicks the Invite button for one or more friends, those friends will receive a notification containing the sender's DisplayName, username, and the experience name. Notifications may be further customized as outlined in Set notification options.

Multiple Friends

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

local player = Players.LocalPlayer

-- Function to check whether the player can send an invite
local function canSendGameInvite(sendingPlayer)
	local success, canSend = pcall(function()
		return SocialService:CanSendGameInviteAsync(sendingPlayer)
	end)
	return success and canSend
end

local canInvite = canSendGameInvite(player)
if canInvite then
	SocialService:PromptGameInvite(player)
end

Specific Friend

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

local player = Players.LocalPlayer
local receiverUserID = 505306092

-- Construct invite options with friend's user ID
local inviteOptions = Instance.new("ExperienceInviteOptions")
inviteOptions.InviteUser = receiverUserID

-- Function to check whether the player can send an invite
local function canSendGameInvite(sendingPlayer)
	local success, canSend = pcall(function()
		return SocialService:CanSendGameInviteAsync(sendingPlayer, receiverUserID)
	end)
	return success and canSend
end

local canInvite = canSendGameInvite(player)
if canInvite then
	SocialService:PromptGameInvite(player, inviteOptions)
end

Include launch data

To further improve in-experience cooperation or to incentivize player invites, you can include launch data in an invite prompt, useful for scenarios such as routing invited friends to a coordinate location or personalizing the joining game for the invitee.

1. When prompting an invite, include an ExperienceInviteOptions object with relevant data that will be used when the friend joins the game, for example the sender's Player.UserId, the ID of a badge to award to the friend upon joining, or a coordinate location to spawn the friend at. If you need to compile multiple pieces of data, encode the data using JSONEncode().

Multiple Friends

local HttpService = game:GetService("HttpService")
local SocialService = game:GetService("SocialService")
local Players = game:GetService("Players")

local player = Players.LocalPlayer

local data = {
	senderUserID = player.UserId,
	spawnLocation = {12, 48, 205.5}
}

local launchData = HttpService:JSONEncode(data)

-- Construct invite options with launch data
local inviteOptions = Instance.new("ExperienceInviteOptions")
inviteOptions.LaunchData = launchData

-- Function to check whether the player can send an invite
local function canSendGameInvite(sendingPlayer)
	local success, canSend = pcall(function()
		return SocialService:CanSendGameInviteAsync(sendingPlayer)
	end)
	return success and canSend
end

local canInvite = canSendGameInvite(player)
if canInvite then
	SocialService:PromptGameInvite(player, inviteOptions)
end

Specific Friend

local HttpService = game:GetService("HttpService")
local SocialService = game:GetService("SocialService")
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local receiverUserID = 505306092

local data = {
	senderUserID = player.UserId,
	spawnLocation = {12, 48, 205.5}
}

local launchData = HttpService:JSONEncode(data)

-- Construct invite options with friend's user ID and launch data
local inviteOptions = Instance.new("ExperienceInviteOptions")
inviteOptions.InviteUser = receiverUserID
inviteOptions.LaunchData = launchData

-- Function to check whether the player can send an invite
local function canSendGameInvite(sendingPlayer)
	local success, canSend = pcall(function()
		return SocialService:CanSendGameInviteAsync(sendingPlayer, receiverUserID)
	end)
	return success and canSend
end

local canInvite = canSendGameInvite(player)
if canInvite then
	SocialService:PromptGameInvite(player, inviteOptions)
end

Note

Always remember to include inviteOptions containing the launch data (maximum of 200 characters) as the second parameter of PromptGameInvite().

1. For incoming friends who join via the notification, check for launch data on the server side through Player:GetJoinData(). If you encode multiple pieces of data into JSON for the invite prompt, remember to decode it with JSONDecode().

   local HttpService = game:GetService("HttpService")
   local Players = game:GetService("Players")
   
   local ATTEMPT_LIMIT = 10
   local RETRY_DELAY = 1
   
   local function onPlayerAdded(player)
       local launchData
   
       for _ = 1, ATTEMPT_LIMIT do
           task.wait(RETRY_DELAY)
           local joinData = player:GetJoinData()
           if joinData.LaunchData ~= "" then
               launchData = joinData.LaunchData
               break
           end
       end
   
       if launchData then
           local data = HttpService:JSONDecode(launchData)
           print(data.senderUserID)
           print(data.spawnLocation)
       else
           warn("No launch data received!")
       end
   end
   
   Players.PlayerAdded:Connect(onPlayerAdded)

Note

Launch data can take a few seconds to appear after the friend joins from the invite. As shown in the code sample above, it's recommended that you wait until the launch data arrives before attempting to use it.

1. If the launch data exists, you can use it for a wide variety of design scenarios, including:

   • Spawn the incoming friend at the beginning of a challenging obstacle course that the sender just completed, based on a coordinate location passed through the launch data.
   • Check if the sender is in the place, based on their Player.UserId in the launch data, and teleport the friend's character near their character.