Use Origin Trials in Microsoft Edge
Developers may use Origin Trials to try out experimental APIs on live sites for a limited period of time. When using Origin Trials, users of Microsoft Edge that visit your site may run code that uses experimental APIs. To access the experimental APIs on each user machine, you do not need to go to
edge://flags and turn on feature flags. For more information, see experimental APIs. Additionally, you may provide feedback on the design of the API, your use cases, or your experience using the APIs to browser engineers and the web standard community.
Get started using Origin Trials
For more information about the experimental APIs available in Microsoft Edge, see Microsoft Edge Origin Trials Developer Console. Ensure that you review the minimum version requirements for Microsoft Edge, and the trial end date to assess suitability of using the experimental APIs on your website.
An experiment may end earlier than planned if any of the following situations occur.
- A major security incident.
- If sufficient feedback is collected that indicates a major redesign is needed to meet the needs of web developers.
In either case, a notification email is sent to all developers currently enrolled in the experiment.
Register for a trial of an experimental API
Use the following steps to register for a trial of an experimental API.
Visit the Microsoft Edge Origin Trials Developer Console page.
Choose the Register button on any of the available experiments.
Sign into the Developer Console using your GitHub username and password.
Choose Authorize MicrosoftEdge.
Complete the form.
To enroll a single or all subdomains, choose set the
Do you need to match all subdomains for the provided origin?setting to
Yes. For example,
https://dev.contoso.comis a single domain, and
https://*.contoso.comuses a wildcard to represent all subdomains.
The following origin formats are not allowed.
Specifying a subfolder on the origin. For example,
Using an origin with query string parameters. For example,
Choose ACCEPT and REGISTER.
Apply your token
A token is instantly generated and displayed on the Microsoft Edge Origin Trials Developer Console page. To begin using the trial on your website, use either of the following methods to apply the token to your page.
origin-trialattribute value and your token to the
metatag on every page that uses the experimental API.
<meta http-equiv="origin-trial" content="replace-with-your-token">
Origin-Trialto the HTTP response header of your server.
Your token is valid for 6 weeks. Before your trial ends, reminder emails are sent to you that ask for your feedback and ask you to consider renewing your trial before your token expires.
Opt out of an experiment
To opt out of an experiment, use one of the following methods to remove your token.
metatag from every page that used the experimental API.
<meta http-equiv="origin-trial" content="your-token">
Origin-Trialfrom the HTTP response header of your server.
Detect experimental features and provide a fallback
When using experimental APIs, ensure you provide a working experience to all visitors of your website. Visitors may use browsers that do not support the experimental APIs that you added to your code. Additionally, if your token expires before you renew it, the experimental API is no longer available which may result in errors. To avoid this situation, ensure you detect features available in your browser. For more information, see Implementing feature detection.
Roadmap for Allowed Origins
The Microsoft Edge Origin Trials portal today only supports SSL Enabled Origins, which means that websites must have HTTPS properly implemented to register for an experiment. In the future, the following secure origins are planned.
http://localhostas the origin for your experiments. To use
http://localhosttoday, go to
edge://flagsand set the experiment to Enabled.
- Use extensions with
extensions://prefixed origins to enroll in experiments.