Skip to main content

Configuring Project Settings

Set your Lens's target platform, name, icon, and platform settings in the Project Settings window, and clear the checks it lists before you publish.

The Project Settings window is where additional info, required for Lens submission, is configured. To access the Project Settings window, click the Project Settings button in Lens Studio's toolbar.

You should make sure the Lens Project Settings is configured properly before submitting the Lens. Below are the various settings that are configurable through the Project Settings window.

The Project Settings window with Target Platform set to Snapchat and General selected: the sidebar on the left, the Lens name, Camera Kit, Lens size and API settings in the center, the Lens Preview on the right, and the list of settings to fix before publishing at the bottom right

At the top of the window, Target Platform sets which platform the Lens is made for.

On the left sidebar, you will find the various categories of settings you will need to configure.

In the center, you will find the settings for each category.

On the right side, you will find a summary of your Lens settings, which were configured.

In the bottom right, you will see a list of validation checks you will need to complete before you publish your Lens.

Finally, the Publish button itself.

When building for SPECS, set Target Platform at the top of the window to SPECS. The sidebar on the left then holds these pages:

  • General: the Lens name, the Lens size, and the API settings.
  • Distribution Settings > Lens Icon: the icon packaged with the Lens.
  • Platform Settings > SPK Settings: the package ID, build version, and signing key that SPECS needs to publish the Lens.
  • Platform Settings > Lens Permissions: the permissions your Lens requests.

The selected page's settings are in the center. At the bottom right, Please fix the following settings before publishing lists every setting you still need to complete; select an item to go to it. Publish, at the top right, uploads your Lens. See Publishing Your Lens.

The Project Settings window with Target Platform set to SPECS, Lens Permissions selected in the sidebar, and the list of settings to fix before publishing at the bottom right

The name, description, tags, category, and previews that Lens Explorer shows are set in the SPECS Developer Portal when you publish, not in Lens Studio.

General

When building for SPECS, General holds the Lens name, the Lens size, and the API settings.

The General page of Project Settings for a SPECS project: Name your Lens, Lens Size (used of 25 MB, and SnapML size used of 10 MB), and API Settings with Experimental API

Lens Name

The name of your Lens. This will be shown to users when they receive the Lens. It's also how people can identify, and search for your Lens.

Your Lens name must be 18 characters or less, containing only letters, numbers, or spaces.

The name of your Lens in the project, 18 characters or fewer. When building for SPECS, the name Lens Explorer shows is the one you enter in the SPECS Developer Portal.

To give the name in other languages, select a localization file in Lens Name Localizations.

Platform Settings

Target Platform, at the top of the window, sets which platform the Lens is made for: Snapchat or SPECS.

The Target Platform menu at the top of Project Settings, open, with Snapchat checked and SPECS below it

On the General page, the Camera Kit checkbox sets whether a Snapchat Lens is also made for Camera Kit.

Changing the target platform changes which pages appear under Platform Settings in the sidebar. For Snapchat, that's Mobile.

Target Platform

Target Platform, at the top of the window, sets which platform the Lens is made for. Select SPECS to build a SPECS Lens. Changing the target platform changes which pages appear under Platform Settings in the sidebar.

Size

The size of the compressed Lens that will be uploaded upon submission. The size limit for a submitted Lens is 8 mb but we advise staying at 2 mb or less for a quicker download. For more information, refer to the Performance and Optimization guide. For information on optimizing 2D images, see the 2D Optimization guide.

If you are working on building Sponsored Lenses, please make sure your Lens is less than 4MB to ensure the most optimal performance across the widest array of devices.

In addition to the Lens Size, you can have up to 10mb dedicated to ML model when you’re using the SnapML Machine Learning component.

The size of the compressed Lens that you upload when you publish. When building for SPECS, a Lens can be up to 25 MB, and Lens Studio recommends staying under 6 MB. In addition to the Lens size, a SnapML model can use up to 10 MB. To make your Lens smaller, see Texture Optimization and Optimizing Lens Performance.

API Settings

When Experimental API is enabled, you will have access to additional APIs. However, this will limit your ability to publish your Lens!

This is mostly used when developing for Spectacles.

When Experimental API is on, your Lens can use APIs that are still experimental, but you can't publish it. Save the project before you turn it on. See Experimental APIs.

Distribution Settings

Discoverability

This allows you to configure settings that will help your Lens show up to various Snapchatters.

Tags of the Month

Tags of the Month is a way for Lens Creators to get exclusive access to the hottest Lens topics of the month. Tags are sourced from both on-platform and off-platform repositories to highlight the “hottest” themes/trends of the moment. Creating high quality Lenses related to these tags, and tagging them here will increase your chances of being featured across a number of places in the app.

Learn more about Tags of the Month in the Submitting your Lens guide.

Other Lens Details

You don't need to change any settings here, as you’ll be able to set these in My Lenses during submission.

Lens Icon

The icon for the Lens is packaged with the Lens. They help identify your Lens for Snapchatters to come back to.

The icon is packaged with your Lens, and the SPECS Developer Portal shows it in your store listing: you don't upload it separately. Publishing needs one: the portal rejects a build without an icon.

You can Import an image, or generate one using GenAI Suite. To learn more about creating an icon, follow the Creating an Icon guide.

With your icon selected, you can use the built in crop tool to change how you want your icon to look.

If your icon has a transparent background, you can enable the Background option and select a background color.

Your selected icon will appear in the right side of the window.

For example, using GenAI Suite, with the prompt horror in the style of Vector art you can add a Lens icon like so:

Lens Preview

A Lens Preview is also packaged with your Lens. A preview shows off your Lens in Lens Explorer and will be visible to the public. Click on + to pick a pre-made video or upload your own. For more information on Preview Videos, please refer to the Preview Videos guide.

Once you’ve selected your preview, you should see the chosen preview in the right side of the window.

Platform Settings

Mobile

When building for mobile devices, Lenses can be configured to work on different platforms and enabled for different cameras.

Lens Works On

This setting indicates which side of the camera your Lens works on. For example, Face Lenses will automatically be enabled on both sides as long as a face is found. However, a Location AR experience may only be built for the rear camera.

If you are working on building Sponsored Lenses, you should make sure that your Lens utilizes Both Cameras. By not having both a world and face camera experience for your Lens, it may receive less distribution in the carousel and may negatively impact any advertising campaigns using this Lens.

Activation Camera

Activation Camera indicates which camera your Lens is optimized for—this impacts which camera your Lens will default to upon start up.

Camera Hint

The hint is a suggestion given to the user to help instruct interaction. The hint appears as soon as the Lens is turned on and fades out after a set number of seconds. For more information, refer to the Lens Hints guide.

The built-in hints are useful as they are localized to the region the user is in.

SPK Settings

SPECS installs a Lens as an SPK package. SPK Settings holds what the package needs before you can publish it:

  • Package ID: the ID that identifies your Lens, such as com.example.mylens: at least two lowercase segments separated by dots, each starting with a letter and using only letters, numbers, and underscores. It has to be unique: no other developer can have used it. The default, mylens, isn't valid.
  • Build Version: the version of this build, in major.minor.patch format such as 1.0.0. Each build you publish needs a version greater than the greatest version already published.
  • Signing Key: the production key that signs your Lens. Create or assign one here. Keep using the same key for every update of the Lens.

Lens Permissions

When building for SPECS, your Lens may use features that need the user's permission. Lens Permissions lists the permissions your Lens requests, which Lens Studio declares from the APIs it uses. When your Lens needs none, it shows No Additional Permissions Granted. See Permissions Overview.