# Analyze layout async

> The **Analyze Layout Async** activity uses the Form Recognizer [Analyze Layout](https://westus2.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-v2-preview/operations/AnalyzeLayoutAsync) API to asynchronously extract layout information from a specified document (**File Path** or **File URL**). After completing the operation, the activity outputs the location of the results in a `String` (**Result Location**).

The **Analyze Layout Async** activity uses the Form Recognizer [Analyze Layout](https://westus2.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-v2-preview/operations/AnalyzeLayoutAsync) API to asynchronously extract layout information from a specified document (**File Path** or **File URL**). After completing the operation, the activity outputs the location of the results in a `String` (**Result Location**).

## How it works

The following steps and message sequence diagram is an example of how the activity works from design time (that is, the activity dependencies and input/output properties) to run time.

1. Complete the [Setup](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-azure-form-recognizer-setup#setup) steps.
2. Add the [Azure Form Recognizer Scope](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-azure-form-recognizer-scope#azure-form-recognizer-scope) activity to your project.
3. Add the **Analyze Layout** activity inside the **Azure Form Recognizer Scope** activity.
4. Enter values for the [Input](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-azure-form-recognizer-analyze-layout#input) properties.
5. Create and enter the `AnalyzeOperationResult` and `Page[]` variables for the [Output](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-azure-form-recognizer-analyze-layout#output) properties.
6. Run the activity.
   * Your input properties are sent to the [Analyze Layout](https://westus2.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-v2-preview/operations/AnalyzeLayoutAsync) API.
   * The API returns the `AnalyzeOperationResult` and `Page[]` values to your output property variables.

     ![docs image](https://dev-assets.cms.uipath.com/assets/images/marketplace/marketplace-docs-image-33579-04f7419b-3c0c8e8e.webp)

## Properties

The values for the following properties are specified when adding this activity to your project in UiPath Studio.

### Common

#### DisplayName

The display name of the activity.

| Attributes | Details |
| --- | --- |
| **Type** | `String` |
| **Required** | Yes |
| **Default value** | *Analyze Layout* |
| **Allowed values** | Enter a `String` or `String` variable. |
| **Notes** | N/A |

### Input

#### File URL

The URL to the file that you want to analyze.

| Attributes | Details |
| --- | --- |
| **Type** | `String` |
| **Required** | Yes (if **File Path** is empty) |
| **Default value** | Empty |
| **Allowed values** | Enter a `String` or `String` variable. |
| **Notes** | Enter a value for either **File URL** or **File Path** (not both).  Supported receipt file formats: PNG, JPEG, TIFF, and PDF (all other format types are ignored). |

#### File Path

The local path to the file that you want to analyze.

| Attributes | Details |
| --- | --- |
| **Type** | `String` |
| **Required** | Yes (if **File URL** is empty) |
| **Default value** | Empty |
| **Allowed values** | Enter a `String` or `String` variable. |
| **Notes** | Enter a value for either **File URL** or **File Path** (not both).  Supported receipt file formats: PNG, JPEG, TIFF, and PDF (all other format types are ignored). |

### Misc

#### Private

If selected, the values of variables and arguments are no longer logged at Verbose level.

| Attributes | Details |
| --- | --- |
| **Type** | Checkbox |
| **Required** | No |
| **Default value** | Not Selected |
| **Allowed values** | Selected or Not Selected |
| **Notes** | N/A |

### Output

#### Result Location

The URL containing the **Result ID** used to track the progress and obtain the result of the operation.

| Attributes | Details |
| --- | --- |
| **Type** | `String` |
| **Required** | No (required to use the output data in subsequent activities) |
| **Default value** | Empty |
| **Allowed values** | Enter a `String` variable |
| **Notes** | For more information, see **Operation-Location** in the Analyze Form API documentation. |