Input parameters allow you to embed the same app in multiple dashboards or notebooks using different configurations for each instance.

Example app

A common use case for input parameters is to reuse and customize an app for different environments, like dev, staging, and production. In the screenshot below, one app is embedded twice in a dashboard. The app on the left shows monitors in the demo environment, while the app on the right shows the same information for monitors in the staging environment. You can play around with this app by cloning the blueprint How to: Input Parameters.

Create an input parameter

1. In App Builder, select an app and click Edit.
2. Click the App Properties icon ().
3. Click the plus icon () to add an input parameter.
4. Click the new input parameter to configure its elements:
   • Parameter Name
   • Display Name (Optional)
   • Data Type
   • Allowed Values
   • Default Value
   • Description (Optional)
5. Click Save.

Example input parameter

This example input parameter shows the same app in various staging environments:

Use input parameters

To embed an app with input parameters:

1. In App Builder, select an app with a configured input parameter.
2. Click Add to a dashboard.
3. Select a dashboard, then click Save and Open.
4. In your dashboard, hover over the app and click the Edit icon ().
5. In the Input Parameters section, select an input parameter:

6. Click Save.

Reuse an app

After embedding an app in a dashboard or notebook, you can create a copy to reuse it with different contexts:

1. Select the embedded app.
2. Click the Options icon (), then click Clone.
   • Alternatively, you can select the app and use copy and paste keyboard shortcuts.
3. Follow the steps above to select a different input parameter.