> This page is for Developer Documentation.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.benchling.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.benchling.com/_mcp/server.

# App Configuration

*App Configuration* lets app developers include configuration options that let Benchling
users customize their app experience. Configuration options can include Benchling
dependencies like schemas, folders, and projects, as well as generic types like text,
integers, and checkboxes. They can help Benchling users get an app up and running, or
change how the app functions without requiring work from the app developer.

![A Benchling App's Configuration tab showing several configuration fields](/_fern-files/_img/2b3e4d1cb3ca5ae341f057f975be8a9e028d5336279092de17d76040f88a6e6d.webp)

## Adding app config to an app

The shape of the app config is defined in the
[app's manifest](/docs/app-manifest-reference).

While developing a Benchling App doesn't technically require a manifest, app framework
features like app configuration and app canvas currently do require uploading a manifest
through the UI or the
[API](/docs/api/v2-beta/benchling-api-beta/app-definitions/get-benchling-app-definition-version-manifest).

## Setting config values

Admins set config values in the Configuration tab within the App Workspace.

The **App Workspace** is the public face of an app in Benchling. All users on a tenant
can reach it through the sidebar menu under Connections > Apps, and it's where users are
directed whenever they click on the app elsewhere in Benchling.

*All* apps have a homepage once created on a Benchling tenant, but only apps that include
app configuration in their manifest have a configuration page.

![An app configuration page with a dropdown selecting a schema for the Molecule Schema field](/_fern-files/_img/0a102f793c7a92f867bba7cca0ccac12c1e36da255981da111db1e73229a8d28.webp)

For a worked example of defining configuration in a manifest and reading it back at
runtime, see
[building your first app with App Configuration](/docs/building-your-first-app-with-app-configuration).