Topics API: experiment and participate

Quick guide to implement and test the API. Access topics with JavaScript and share your feedback.

Key point: The Privacy Sandbox Relevance and Measurement origin trial ended September 20, 2023 and the APIs are now available for 99% of Chrome users, and origin trial enrollment has closed. To keep abreast of the percentage of users each API is enabled for, refer to the Chrome status graphs.

Learn the essentials

• Topics API overview introduces the API and explains the issues it addresses.
• Topic classification explains the classifier model, how topics are inferred and assigned to users' browsers, and how users can control their topics list.
• The Topics API developer guide covers setup, getting and setting topics using JavaScript and headers, and debugging.

Try the API

1. Check the Privacy Sandbox status page for updates on the implementation status of the Topics API.

2. Experiment with the API:

   • Try out Topics for a single user in Chrome 101 or newer by enabling all the Ad privacy APIs under chrome://settings/adPrivacy or by running Chrome from the command line with the --enable-features=PrivacySandboxAdsAPIsOverride feature flag. Refer to Topics API demos.
   • The Topics API developer guide explains how to use the Topics JavaScript API or the header approach (fetch or iframe) to access topics observed for the current user.

Get support

Is anything blocking you from experimenting with the API? Ask a question about your implementation or about the documentation:

• Open a new issue on the Privacy Sandbox Dev Support repository. Make sure to select the issue template for Topics.
• For more general questions about how to meet your use cases with the API, file an issue on the API repository.

For bugs and issues with the implementation of the Topics API in Chrome:

• View existing issues reported for the API.
• Raise a new issue at crbug.com/new.

Join the discussion

Everyone is welcome to join in discussion of the Topics API. In particular, if you're experimenting with the API, your feedback is essential.

Discuss the API

Like other Privacy Sandbox APIs, this API is documented and discussed publicly.

• Read the explainer on GitHub.
• Join the conversation about existing issues.
• Open a new issue to ask a question, propose a feature, or discuss a use case.

Discuss related topics

• Discuss industry use cases in the Improving Web Advertising Business Group.

Give feedback

• Use the Privacy Sandbox feedback form to share feedback privately with the Chrome team outside of public forums.
• Privacy Sandbox Feedback explains how to provide other types of feedback, and how to engage in discussion of Privacy Sandbox APIs.

Get updates

• To be notified of status changes in the API, join the mailing list for developers.
• To closely follow all ongoing discussions on the API, click the Watch button on the GitHub page on GitHub. This requires you have or create a GitHub account.
• To get overall updates on the Privacy Sandbox, subscribe to the RSS feed [Progress in the Privacy Sandbox].