Type Library
Revision Current Public Release (2016.2992)
Keywords ads, advertising, Chartboost
Platforms Android, iOS


The Chartboost plugin allows developers to monetize users through Chartboost static interstitial, video interstitial, rewarded video ads, and more.

The Chartboost plugin is only available to users who have purchased the Corona Professional Bundle or the Chartboost plugin. This plugin lets you keep 100% of your ad revenue and allows you to manage your account/settings with Chartboost directly.

Due to recent Android dependency updates, this plugin requires daily build 2016.3005 or later.


Before you can use this plugin, you must register with Chartboost.


local chartboost = require( "plugin.chartboost" )



Project Settings

To use this plugin, add an entry into the plugins table of build.settings. When added, the build server will integrate the plugin during the build phase.

settings =
    plugins =
        ["plugin.chartboost"] =
            publisherId = "com.coronalabs"

In addition, please add the appropriate OS version restriction specified below to prevent your Chartboost-enabled apps from being installed on incompatible devices:

settings =
    iphone =
        plist =
            MinimumOSVersion = "7.0"

If you are building for Android, you should remove any legacy inclusion of the [""] plugin from your build.settings.


For Android, the following permissions/features are automatically added when using this plugin:

  • "android.permission.INTERNET"
  • "android.permission.ACCESS_NETWORK_STATE"
  • "android.permission.WRITE_EXTERNAL_STORAGE"

In addition, you can add the following optional (but recommended) permissions:

  • "android.permission.ACCESS_WIFI_STATE" — Allows the Chartboost SDK to check WiFi details and send the MAC address in the HTTP request. This will be used alongside the Android ID and/or GAID (where applicable) as the identifier for the user.

  • "android.permission.READ_PHONE_STATE" — Allows the Chartboost SDK to handle calls interrupting video playback during videos.