--- layout: api title: "v1.6.0 API: Retina" categories: api version: v1.6.0 permalink: /api/v1.6.0/retina ---

## Retina

Having the ability to use retina tiles when the device supports them is easy. When creating the map, use the `detectRetina` to verify if retina is available and `retinaVersion` to use a tilelayer which is designed for retina screens.

    var map = L.mapbox.map('map', 'your.mapid', {
        tileLayer: {
            detectRetina: true,
            retinaVersion: 'your.mapid'
        }
    }).setView([40, -74.50], 9);

Some Mapbox maps support switching to retina scale automatically: if you're using one of these maps, you can simply set `detectRetina` and the higher-scale tiles will be used when retina is detected.

    var map = L.mapbox.map('map', 'your.mapid', {
        tileLayer: {
            detectRetina: true
        }
    }).setView([40, -74.50], 9);