User Reporting Service
Updated: Jul 22, 2024
As described in
VRC.Content.3, all apps with user-generated content (including synchronous or asynchronous multiplayer environments) must have a form for users to notify you about user conduct and user generated content in the application that does not adhere to Meta’s
Code of Conduct for Virtual Experiences. Examples of asynchronous multi-user environments include:
- Apps which display usernames on leaderboards
- Apps that allow users to upload their own in-app creations for other users to view
Apps that do not have any means of user interaction (such as single-player games or fitness apps without leaderboards) are not subject to this VRC.
Note:The reporting button is only available to users if your app has multiplayer or co-op game modes. You can see and update your game modes in the
Developer Dashboard under
App Submissions →
App Metadata →
Specs.

The user reporting service is a tool that creates a lightweight interface for collecting user reports within your app. You can use this tool if you don’t have your own in-app reporting UI.
With the user reporting service, a user will launch the report flow by pressing the

button and clicking the
Report Abuse button in the universal menu. When a user submits a report it will be emailed to you. Once you receive the report, consider sending the user a follow-up confirmation email to help you build trust.
Setting up roles and permissions
If you are an admin or have
Manage App and
Platform Services permissions, skip to
the next section. Otherwise use the following steps to set up a user reporting role and give it the permissions you’ll need to use the user reporting service:
- Open your browser and navigate to the Developer Dashboard.
- If you’re in the App Manager view, expand the dropdown list of your apps, and click View All to open the Org Manager.
- From the Org Manager view, click Members in the left-side navigation.

- Click Create Role.
- Give the role a name and optional description. You can also restrict access to selected apps in your organization by choosing App Constraints.

- From Permissions click App to view the list of app-specific organization permissions.
- From the list, choose both Manage App and Platform Services

- For Members click + Add New to add the members of your organization who will use the user reporting service for the apps this role specifies.
- When you’re done adding permissions, click Create.
Note: All organization members with the Platform Services permission, will be able to view and use the Platform Services page for your organization.
Setting up the user reporting service
Use the following steps to set up the user reporting service:
- Open your browser and navigate to the Developer Dashboard.
- Click My Apps in the left-side navigation and choose the app that you want to use the user reporting service with.
- Click Platform Services in the left-side navigation and click Add Service under User Reporting.
- Click Get Started to begin customizing the user reporting service for this app.

- Once you’ve finished your customizations, click Activate to enable the user reporting service.

Customizing a reporting flow
Once you have the necessary organization permissions, you can customize how you recieve and act on user reports in the following ways:
- Select your primary reporting tool (either the user reporting service or the plugin)
- Choose a delivery channel to receive your encrypted user reports (either email or the secure inbox in platform services)
- Provide an email address to receive your encrypted user reports
- Request a reporting user’s email adddress
- Select report reasons
- Add custom report reasons
- Upload a brand asset to display in your user reporting experience
Generating a decryption key for encrypted user reports
Starting February 1, 2024, you’ll need to generate and use a decryption key to open the user reporting inbox on the Platform Services page of the Developer Dashboard.
It’s important to keep your key safe. Meta does not have a copy of your decryption key. We recommend that you do one or all of the following:
- Write it down
- Copy and paste the key into a password manager
- Take a screenshot
If you do lose your key, you can generate a new one. However, user reports secured behind your previous key will be lost and you won’t be able to read them again.
Select the right report reasons
After enabling the user reporting service, it’s important that you select the right report reasons for your app. Selecting a focused list of report reasons ensures that you can monitor and take action on inappropriate behavior to adhere to the
Code of Conduct for Virtual Experiences. You can also refer to the Code of Conduct to help you choose the right report reasons specific to your app environment.
The currently available report reasons are below. More information on these reasons can be found in the current Code of Conduct.
- Bullying
- Hateful behavior
- Child exploitation and abuse
- Child sexualization
- Coordinating harm
- Self harm
- Underage person (under 13)
- Excessive violence
- Dangerous organizations
- Human exploitation
- Nudity/Pornography
- Impersonation
- Fake accounts
- Doxing
- Hacking
- Regulated goods
- IP infringement
- Spam
- Fraud/Scams
- Something else
It is recommended that you select between 5 and 7 report reasons for your app to ensure users are able to make an accurate choice for the report they want to send.
Add a custom report reason and localization
You can also create a custom report reason by clicking on Add Custom Reason on the Customize User Reporting page. Your custom reason will then be added to the list of reasons users can select. Try to keep any custom reason to no more than 50 characters.
To translate a custom reason, select Manage Languages. After choosing a language, you can manually enter a translation.
You can upload a branded asset that will display in the user reporting experience. Branding your user reports is optional, but can go a long way in building trust with your community and establishing your brand. For best results, upload a branded asset in the Branding section of the Customize User Reporting page that is 1440 x 2560 px (max size) (16:9).
For more information, see the following resources: