Mobile Rich Media Ad Interface Definitions (MRAID)

In Public Review until January 30, 2017: MRAID Version 3.0 has important new features to improve the user’s ad experience. The new MRAID enables the ad to measure viewability and audibility, detect MRAID environment, get location data to present user with the best possible experience. In addition, there is guidance on pre-loading ads and understanding ad readiness to display an ad to the user. The Video Player Ad Interface Definition (VPAID) addendum to MRAID is now fully included in the MRAID specification. Please review the draft for public comment and submit your feedback via email to Shailley Singh, IAB Tech Lab lead on this initiative, at prior to January 30, 2017. You should not rely on this public comment draft. Please wait for the final specification to be published in early 2017.

MRAID 3.0 Draft for Public Comment | Read the press release | Email us your feedback


MRAID, or “Mobile Rich Media Ad Interface Definitions” is the common API (Application Programming Interface) for mobile rich media ads that will run in mobile apps. This is a standardized set of commands designed to work with HTML5 and JavaScript that developers creating rich media ads use to communicate what those ads do (expand, resize, get access to device functionalities such as the accelerometer, etc) with the apps into which they are being served.

Without MRAID different apps (incorporating different rich media vendors’ SDKs) have disparate requirements in terms of the APIs that creative developers must use to communicate with the app. Therefore, the same creative must be rewritten in order to run across different apps. MRAID offers a single API that diverse SDK vendors will support, which means that MRAID-compliant rich media ads will run within applications using any MRAID-compliant SDK. MRAID therefore enables creative agencies and rich media shops to more quickly and easily build rich creative that will run in different publishers’ mobile apps.

MRAID has been developed by the IAB Tech Lab Mobile Rich Media Ad Interface Definition (MRAID) Working group and the IAB Mobile Marketing Center of Excellence.

Current Version

MRAID 2.0 is accompanied by the MRAID Video Addendum to address video ads in MRAID environments using VPAID.

Other supporting documents

Tools and Utilities

The IAB Tech Lab and the MRAID working group has developed multiple tools and utilities to help developers test and validate their MRAID ads as well as MRAID implementations in their app or ads SDK.

MRAID v2.0 Test Ads: 
The compliance test consists of six test ads created and vetted by the IAB’s MRAID Working Group. These tests serve as an objective verification that the SDK being tested has correctly implemented all the features of the MRAID v2 specification, ensuring greater certainty for the industry. Documentation for each of the six test ads, including links to where the creative can be accessed for testing, can be downloaded via the following:

Single-Part Expandable Ad

Two-Part Expandable Ad

Full-Page Ad

Resize Ad

Resize Ad Designed to Cause MRAID Errors

Video Interstitial Ad 

MRAID 2.0 Web Tester: MRAID 2.0 Ads can be tested for proper function and performance using the MRAID Web Tester available here.

MRAID Ads SDK Tester: To test MRAID ads in specific SDKs, users can download the IAB MRAID Ads SDK Tester app from here.

Previous Version


Developed by the Mobile Rich Media Ad Interface Definitions (MRAID) Working Group

IAB Tech Lab Contact

Shailley Singh
Senior Director, Product and Research & Development