Skip to main content

Pairing to Snapchat

With Lens Studio, you can preview your Lenses inside Snapchat. Once you're signed in, any changes you make in Lens Studio are reflected in preview Lenses on your mobile device. Previewing your Lenses inside Snapchat will help you test and iterate on the Lens' user experience.

To preview your Lenses in Snapchat, you'll need the latest version of Snapchat as well as the latest version of Lens Studio.

Connecting Your Device

To preview your Lenses on your device, sign in to Lens Studio with your Snapchat account. Lens Studio sends Lenses to the Snapchat account you're signed in with, so open Snapchat on a device that's logged in to the same account.

Until you sign in, the Preview Lens button is disabled and its tooltip reads "Log in to your Snapchat account to preview this Lens".

When working with multiple devices or on Connected Lenses, use the arrow next to the Preview Lens button. It has Send to All, Send to All Snapchat, Send to All Snapchat with Lens Profiler, Send to All Camera Kit, and Cancel Upload. It has no entry for pairing an account.

If you want to remove the paired Lens from Snapchat, first open Snapchat. Then, go to Settings. There, select Additional Services > Manage > Lens Studio > Pair Status, then tap Unpair. This will unpair your device and remove the paired Lenses from your Lenses carousel. Note, you might have to force quit and reopen Snapchat if you want the Lenses removed immediately.

Previewing Your Lenses

Now that you're signed in, you can push your Lenses to Snapchat to preview them.

  1. Click Preview Lens in the toolbar to send your Lens to Snapchat for preview

    The Preview Lens button, outlined in red, at the right end of the toolbar beside Publish.
  2. While the Lens is sending, the button reads Sending Lens.

    The Preview Lens button reading Sending Lens while the push is in progress.
  3. Once the Lens has been sent to your device, the button will display the Lens Sent message.

    The Preview Lens button showing the Lens Sent message after the push succeeds.
  4. Finally, once the push is successful, you should now see your Lenses for preview in your Lenses carousel. The icons of the Lenses will be whatever you set them to in the Project Settings window.

    Pairing to Snapchat

If you don't see your Lens in your carousel, make sure you're on the side of the camera which you've set your Lens to show up in, using the Activation Camera setting in the Project Settings window.

Checking Lens Performance

When your Lens is open in Snapchat, you're able to see the performance of your Lenses. Please refer to the Performance and Optimization guide for performance requirements and best practices. To display your Lenses' performance:

  1. With your Lenses opened in Snapchat, click the Bug button in the top left corner of Snapchat

  2. After clicking the Bug button, you should now see performance stats for your Lenses. 

    • FPS represents your Lenses' frame rates.
    • RAM represents how much memory your Lenses are consuming.
    • SIZE represents how large your Lenses are.
    • LAT represents the Lens Activation Time.
    • a time stamp displays when the Lenses were last pushed.

You can get more details about your Lens performance using the Lens Profiler and Trace Analysis.