---
title: Edit and use applications
description: Configure, share, and present AI-powered apps in Workbench.
section_name: Workbench
---

# Edit and use applications {: #edit-and-use-applications }

Workbench applications have two modes: **Edit** mode, where you can configure, customize, and even use the application, and **Present** mode, an end-user view of the application.

!!! note
     The instructions on this page demonstrate how to edit and use an application in Edit mode.

The tabs below describe each mode in more detail, including the purpose and limitations of each one:

=== "Edit mode"

     To enter Edit mode, when in Present mode, click **Edit** in the upper-right corner. In this mode, you can:

     - Customize the appearance of the application.
     - Share applications.
     - Configure widgets and customize the appearance of widget visualizations.
     - Make predictions and interact with prediction results.
     - View summary information and model insights.
     - Return to your Use Case via the breadcrumbs at the top of the page.

     See the image and table below for a brief description of the interface:

     ![](images/wb-app-edit-1.png)

     &nbsp;      |         Description
     ----------- | ---------------------
     ![](images/icon-wb-1.png)  | Organizes the application using [folders and sections](#application-folders).
     ![](images/icon-wb-2.png)  | Displays the selected folder and its sections (indicated by the open folder on the left).         
     ![](images/icon-wb-3.png)  |   **Share** provides a shareable link that grants recipients access to the application. <br><br>**Present** opens the end-user version of the application. If you are already presenting, DataRobot displays an **Edit** button.           

=== "Present mode"

     To enter Present mode, when in Edit mode, click **Present** in the upper-right corner to enter Present mode. Present mode displays the end-user version of the application that anonymous users (accessing the app via the shareable link) and those with `Consumer` access can access. In this mode, you can:

     - Share applications.
     - Make predictions and interact with prediction results.
     - View summary information and model insights.

     ![](images/wb-app-present.png)

     
## Change themes {: #change-themes }

In the **Themes** tab, you can choose a light or dark theme for your application.

![](images/wb-app-theme.png)

## Upload a custom logo {: #upload-a-custom-logo }

To add a custom logo to your application, click **Upload Logo** and select the image you'd like to use.

![](images/wb-app-logo.png)

## Add sections {: #add-sections }

Although you can't remove default sections from your application, you can add a new section to any of the folders. These custom sections include an editable text field and heading that when edited, also updates the section name in the left panel.

![](images/wb-app-section.png)

To remove a custom section, click the trash icon.

![](images/wb-app-section-1.png)

## Reorder sections {: #reorder-sections }

You can change the order of where sections appear within a folder by dragging them to a new position in the left panel.

![](images/wb-app-reorder.gif)

## Customize visualizations {: #customize-visualizations }

If a section contains a visualization, you can customize its appearance and behavior. To customize a visualization, hover over the chart and click the pencil icon.

![](images/wb-app-viz-2.png)

In the below example, you can change the chart colors, number of bins, sorting order, and partition source. However, the available customization options vary by visualization.

![](images/wb-app-viz-1.png)

## Application folders {: #application-folders }

By default, DataRobot automatically organizes your application by intuitively grouping its content in folders, and within each folder, information, insights, and actions are divided into sections. Default folders and sections cannot be removed, however, you can [add new sections](#add-sections) to a folder. Each application contains the following folders:

   Folder       |       Description
 ----------------- | ---------------------
  [Overview](#overview)       |   Displays general summary information.       
  [Insights](#insights)      |  Displays various model insights.        
 [Predictions](#predictions)     |  Allows you to make and view predictions.        
 [Prediction Details](#prediction-details)     |  Displays individual prediction results. 

### Overview  {: #overview } 

The **Overview** folder contains general summary information for your application.

![](images/wb-app-edit-2.png)

Section       |  Type   |     Description
----------------- |  --------  | ---------------------
Use Case summary       |  Text  | Displays summary information for the application's Use Case.       
Problem statement/Why it's valuable   |  Text    |  Allows you to enter a problem statement and description of application value.        
Experiment summary     |  Text  | Displays summary information for the application's experiment.  
Blueprint Chart     |  Visualization  | Displays the blueprint of the model used to create the application. <br>See the [full documentation](blueprints){ target=_blank }.   
Lift chart     |  Visualization  |  Depicts how well a model segments the target population and how capable it is of predicting the target. <br>See the [full documentation](lift-chart){ target=_blank }.    

### Insights {: #insights }

The **Insights** folder displays several insights (if available) for the original model that was used to create the application.

![](images/wb-app-edit-3.png)

Section   | Type |   Description    
--------  |  -------  |  -------------    
Feature Impact  |  Visualization  | Provides a high-level visualization that identifies which features are most strongly driving model decisions. <br>See the [full documentation](feature-impact){ target=_blank }.
ROC Curve | Visualization |  Provides visualizations and metrics to help you determine whether the classification performance of a particular model meets your specifications. Only available for binary classification models. <br>See the [full documentation](roc-curve){ target=_blank }.
Feature Effects | Visualization  |Visualizes the effect of changes in the value of each feature on the model’s predictions. <br>See the [full documentation](feature-effects){ target=_blank }.
Word Cloud      | Visualization | Displays the most relevant words and short phrases in word cloud format. <br>See the [full documentation](analyze-insights#word-clouds){ target=_blank }.
Prediction Explanations | Visualization |  Illustrates what drives predictions on a row-by-row basis—they provide a quantitative indicator of the effect variables have on the predictions, answering why a given model made a certain prediction. <br>See the [full documentation](predex-overview){ target=_blank }.

### Predictions {: #predictions }

The **Predictions** folder allows you to make single record and batch predictions, as well as, view a history of predictions made in the application.

![](images/wb-app-edit-4.png)

Section       |  Type   |     Description
----------------- |  --------  | ---------------------
All Rows       |  Visualization  | Displays each prediction row generated by the application.       
Single prediction   |  Action    | Allows you to submit single record predictions.         
Batch prediction     |  Action  | Allows you to upload batch prediction files.  

#### Make predictions {: #make-predictions }

To learn how to make both single and batch predictions in an application, see the existing documentation on [making applications](app-make-pred).

### Prediction Details {: #prediction-details }

The **Prediction Details** folder displays prediction results for individual predictions. Note that this folder is disabled until the app is used to make a prediction.

![](images/wb-app-edit-5.png)

Section       |  Type   |     Description
----------------- |  --------  | ---------------------
General Information       |  Text  | Displays prediction information for the selected row.       
Prediction Explanations   |  Visualization    | Displays Prediction Explanations for the selected row.         
What-if and Optimizer     |  Visualization / Action  | Allows you to interact with prediction results using scenario comparison and optimizer tools.

For more information, see the documentation on [app prediction results](app-analyze-result) and the [What-if and Optimizer widget](whatif-opt).

!!! note "Enabling the what-if and optimizer tools"
     By default, only the what-if tool is enabled in the What-if and Optimizer widget. To enable the optimizer tool and/or disable the what-if tool, make sure you're in **Edit** mode. Hover over the widget and click the **pencil** icon. Open the **Properties** tab and use the toggles to customize the widget's functionality.

     ![](images/wb-whatif-1.png)

#### Create what-if scenarios {: #create-what-if-scenarios }

A decision-support tool that allows you to create and compare multiple prediction simulations to identify the option with the best outcome. You can also make a prediction, then change one or more inputs to create a new simulation, and see how those changes affect the target feature.

Learn more about [using](app-analyze-result#create-simulations) and [configuring](whatif-opt) the what-if tool.

#### Optimize predictions {: #optimize-predictions }

Identifies the maximum or minimum predicted value for a target or custom expression by varying the values of a selection of flexible features in the model.

!!! note
     To view optimizations, you must open **Present** mode.

Learn more about [using](app-analyze-result#optimization-simulation-results) and [configuring](whatif-opt) the optimizer tool.


## Share {: #share }

There are two ways to share applications:

1. [Send a shareable link](#generate-a-shareable-link) to DataRobot or non-DataRobot users.
2. [Share the Use Case](wb-build-usecase#share) with other DataRobot users, which provides them with access to all assets contained within it.

### Generate a shareable link {: #with-a-shareable-link }

When using the application&mdash;in either **Edit** and **Present** mode&mdash;you can generate a shareable link. This link provides access to your application and can be shared with non-DataRobot users.

To generate a shareable link: 

1. Click **Share** in the upper-right corner.

     ![](images/wb-app-share.png)

2. Select the box next to **Grant access to anyone with this link**. If this box does not have a check mark, users cannot access the application via the link.

     ![](images/wb-app-share-1.png)

3. (Optional) Toggle **Prevent users with link access from making predictions** to control the ability for recipients to make predictions in the app.

!!! warning "Generate a new link"
     If you click **Generate a new link**, all users with the older link will no longer have access to the app&mdash; you must send a new link to grant access.

