How do I map my Twinkly device? (Twinkly PRO & Plus)

Step by step procedure to perform the mapping process.

Applies to all Gen I and Gen II devices, Twinkly PRO and Twinkly Plus.

3D Front & Back and 2D Stitching are available only for Twinkly PRO and Plus devices.

What is mapping?

Mapping is an exclusive Twinkly feature that allows the Twinkly App to use your smartphone’s camera to scan each LED bulb in your space, creating an advanced 3D virtual layout of your lights.
No matter where you’ve placed your lights, the app will find them.

Choosing a mapping type

Go to the Layout section of the app menu, give the app access to your phone’s camera, and choose whether you want to use the Easy Mapping or Advanced Mapping feature.
Just make sure your device is online!

Some options may depend on the Twinkly device you’re using (e.g. Flex) on your smartphone’s/tablet’s operating system (iOS/Android); and on your device’s connection status (Twinkly direct connection/home Wi-Fi connection).

Schermata doppia


The Flip feature allows you to reflect your layout as in a mirror

Easy Mapping

This kind of mapping is recommended for installations where the lights are mostly on a single surface.

The algorithm will automatically identify the position of the LEDs located on the sides and back of the holder, estimating their position.

Start the process by clicking on “Mapping” and selecting “Easy Mapping”: the LEDs will start flashing quickly and the magic begins!

The mapping ends when the LEDs are on a fixed color. It’s possible to save or repeat the operation.

In case of poor results, a pop-up will indicate the “Poor results” condition and it’s possible to repeat the operation.

Advanced Mapping 

This mapping mode is more advanced because it allows you to make a larger number of scans, resulting in an even more accurate layout.
Choose from 3 options:

  • 3D multiview

This innovative method of mapping LEDs allows you to scan the different sections of your installation an unlimited number of times, for a perfect, 360 ° rendering.

During the mapping process, the LEDs will appear in 4 different colors, based on their status:

  • RED: they don’t still have space coordinates.

  • ORANGE: the LEDs are recognized for the first time by the camera (XY coordinates)

  • YELLOW: the LEDs are recognized for the second time by the camera.

  • GREEN: the LEDs are completely recognized and in a three-dimensional way (depth coordinates)

Following the app, at each step, you will scan your installation by moving the camera angle (during each scan it is necessary to remain as stable as possible with your phone or tablet)

When all the LEDs are green, it means that the entire installation has been properly mapped.

Congrats! Your lights have been mapped and the app will show you your actual Layout.

You can choose to keep it or try again!

  • 3D Front & Back

Choosing this option, you can make two scans of your installation: one at the front and one at the back (suitable, for example, for a column or a Christmas tree).  

  • 2D Stitching

This mode allows you to make more recordings of a large installation in 2D.                           


Starting from version 3.1 of the iOS app, it's available only for Twinkly PRO Ethernet controller the OpenLoop feature that allows the mapping process even if the phone is not connected to Wi-Fi.
It is automatically enabled and requires at least 6000 active LEDs
It also requires that the strings are connected to a router with Internet access.

Important notes:

  • If you wish to redo the mapping procedure and get a new layout, simply click on "Restore"

  • You can restore one of the last 3 layouts using the Layout History feature

  • You can map with the horizontal camera ( enable the camera phone rotation feature)

  • There are some useful tricks to get the best results from the Mapping procedure. Read this article to learn more.

  • To create an effect in 'Drawing mode' LEDS mapping is required (except for Line and Flex which have a linear design

Not found what you were looking for? Contact us.