Enable experimental features
AMP experimental components are released features not yet ready for wide use, so they are protected by an experimental status.
Developers and users can opt-in to using these features before they are fully released. But they should be used with caution, as they may contain bugs or have unexpected side effects.
Opt into the AMP Dev Channel
The AMP Dev Channel is a way to opt a browser into using a newer version of the AMP JS libraries.
The AMP Dev Channel release may be less stable and it may contain features not available to all users. Opt into this option if you'd like to help test new versions of AMP, report bugs or build documents that require a new feature that is not yet available to everyone.
Opting into Dev Channel is great to:
- test and play with new features not yet available to all users.
- use in quality assurance (QA) to ensure that your site is compatible with the next version of AMP.
If you find an issue that appears to only occur in the Dev Channel version of AMP, file an issue with a description of the problem. Always include a URL to a page that reproduces the issue.
To opt your browser into the AMP Dev Channel, go to the AMP experiments page and activate the "AMP Dev Channel" experiment. To get notified about important/breaking changes about AMP, subscribe to the amphtml-announce mailing list.
Enable an experimental component
Served from cdn.ampproject.org
For content served from https://cdn.ampproject.org, go to the AMP experiments page and enable (or disable) any experimental component by toggling them on (or off). Opting in will set a cookie on your browser that will enable the experiment on all AMP pages served through the Google AMP Cache.
Served from other domains
For content served from any other domain, experiments can be toggled in the devtools console when development mode is enabled using:
Any AMP file that includes experimental features will fail AMP validation. Remove these experimental components for production-ready AMP documents.
Enable an experiment for a particular document
Document can choose to opt in a certain experiments. To do that, simply put a meta tag of the
amp-experiments-opt-in name in the head of the HTML document before your AMP script (
https://cdn.ampproject.org/v0.js). Its content value is a comma-separated string of experiment IDs to opt in.
<head> ... <meta name="amp-experiments-opt-in" content="experiment-a,experiment-b"> <!-- The meta tag needs to be placed before the AMP runtime script.--> <script async src="https://cdn.ampproject.org/v0.js"></script> ... </head>
By doing so, the specified experiments will be enabled for all visitors of the document. However, not all experiments allow document-level opt-in. For a full list of whitelisted experiments, see the
allow-doc-opt-in attribute in the project's
prod-config.json file. Note that document opt-in can be overridden by user opt-out.