Applications

Read time: 3 minutes

Last edited: Aug 15, 2024

Overview

This topic explains how to create, edit, and delete applications. An application is a LaunchDarkly resource that describes what you are delivering to a customer.

LaunchDarkly automatically creates applications when it establishes a connection with a LaunchDarkly SDK that contains application information. You can edit and delete applications from the Applications list in the LaunchDarkly user interface (UI).

Create applications

LaunchDarkly automatically creates new applications when it establishes a connection with a LaunchDarkly SDK that supports Application metadata configuration.

We strongly recommend also enabling automatic environment attribute collection as part of your SDK configuration. When this configuration is enabled, you can create mobile targeting rules for your feature flag based on the application information. The SDK provides data on the mobile environment where an application is running, including the application name and id. The SDK includes this data in the ld_application and ld_device contexts. To learn more, read Automatic environment attributes.

After the SDK has evaluated at least one feature flag using an ld_application context, you can create mobile targeting rules based on application and application version information in that context. To learn more, read Mobile app and device targeting.

Add mobile targeting rules only after application information is collected

You can only create a "Mobile" targeting rule, and target mobile apps and devices based on automatically collected application information, if you have completed the following:

your feature flag has its Client-side SDK availability set to include "SDKs using Mobile key." To learn more, read Creating new flags.
you have already started to collect application information in the ld_application and ld_device context kinds. LaunchDarkly must receive these context kinds before it enables the option to create a mobile targeting rule. To learn more, read Environment attributes.

Edit applications

To edit an existing application:

Click the gear icon in the left sidenav to view Organization settings.
Click Applications.
Find the application you want to edit. Click the overflow menu and choose "Edit."
In the dialog, update the Kind, Description, or Maintainer. You cannot modify the application name or key.
Click Save.

You can also use the REST API: Update application

Delete applications

To delete an existing application:

Click the gear icon in the left sidenav to view Organization settings.
Click Applications.
Find the application you want to delete. Click the overflow menu and choose "Delete application."
In the dialog, type the name or key of the application to confirm.
Click Delete.

You can also use the REST API: Delete application