# Extract URLs

Extracts Uniform Resource Locators (URLs) from the input. The protocol (http, ftp etc.) is required otherwise there will be far too many false positives. Extract URLs lives in the **Extractors** category of the `fx` menu.

## Parameters

| Parameter     | Type    | Required | Default | Description                                            |
| ------------- | ------- | -------- | ------- | ------------------------------------------------------ |
| Input         | string  | yes      | —       | Value to transform. Previous step output or a literal. |
| Display total | boolean | no       | `false` | Disabled by default.                                   |
| Sort          | boolean | no       | `false` | Disabled by default.                                   |
| Unique        | boolean | no       | `false` | Disabled by default.                                   |

`Input` is the primary value (previous step output or a literal).

## Returned value

| Type     | Description                                |
| -------- | ------------------------------------------ |
| `string` | Result of the Extract URLs transformation. |

## Example

<details>
<summary>Extract URLs from text</summary>

Pull Uniform Resource Locators from a message or document body.

1. Set **Input** to text that contains URLs. Paste:

   ```text title="Input"
   See https://example.com/a and http://example.org
   ```

2. Confirm **Output value** lists the extracted URLs.

</details>