MapillaryJS is a tool used for displaying street level photos anywhere on the internet. Today we are putting it into your hands. It enables you to add street level photos to your blog, website or even into your professional mapping applications. Getting started with MapillaryJS is easy:

Adding MapillaryJS to your webpage

This is MapillaryJS:

To add it to your webpage include these HTML tags:

<link rel="stylesheet" href="">
<script src=""></script>

Then add the following lines where you want the viewer to be displayed:

<div id="mly">
    var mly = new Mapillary.Viewer('mly'

With MapillaryJS you can create your own story

MapillaryJS has a built in plugin for creating visual stories. Press the button below and tag along for a journey in sunny California.

How to use MapillaryJS

A good place to start expanding your knowledge about MapillaryJS is the documentation. It is fully loaded with examples that will get you started with the more advanced features.

Contribute to MapillaryJS

MapillaryJS is a MIT licensed Javascript library hosted on GitHub built with extensibility in mind. Feel free to contribute, give feedback, suggest features or even make your own fork of MapillaryJS.

What’s next?

We’re starting out with support for a WebGL component with 3D transitions, unified navigation, panoramas, HTML canvas rendering as fallback, a cover feature, and a routing component. Next up we’re adding detected objects, point clouds, smoothed trajectories, and dragging functionality to be able to completely remove the old viewer from

Since MapillaryJS standardizes our work on one single viewer all client integrations will have access to our upcoming features. Currently in the plans are object tagging, rendering map markers, rendering full 3D models, and dynamic journeys. Let us know if you have any requests by filing an issue on GitHub.

I want more!

We have worked hard to get MapillaryJS into your hands and we will continue to add features over time. Keep your eyes open for our next MapillaryJS blog post where we will explain some of the technology choices we made as well as a deep dive into creating your own MapillaryJS plugin.

/ Kamil, Oscar and Johan

Continue the conversation