---
title: URI parts processor
description: Parse a URI string into its components, such as scheme, domain, path, and query, with the Streams URI parts processor in Streamlang.
url: https://www.elastic.co/elastic/docs-builder/docs/3716/solutions/observability/streams/processors/uri-parts
products:
  - Elastic Cloud Enterprise
  - Elastic Cloud Hosted
  - Elastic Cloud Serverless
  - Elastic Cloud on Kubernetes
  - Elastic Observability
  - Elastic Stack
  - Elasticsearch
  - Kibana
applies_to:
  - Elastic Cloud Serverless: Generally available
  - Elastic Stack: Planned
---

# URI parts processor
The **URI parts** processor parses a URI string into its components: scheme, domain, path, query, fragment, port, user info, and file extension.
To parse a URI:
1. Select **Create** → **Create processor**.
2. Select **URI parts** from the **Processor** menu.
3. Set the **Field** to the field containing the URI string to parse.
4. (Optional) Set **Target prefix** to the prefix used for the extracted components, for example `<prefix>.scheme`, `<prefix>.domain`, and `<prefix>.path`. Defaults to `url`.
5. (Optional) Toggle **Keep original** to preserve the raw URI string at `<prefix>.original`. Enabled by default.
6. (Optional) Toggle **Remove source on success** to remove the source field after a successful parse. The source field is kept when parsing fails. Disabled by default.

This functionality uses the Elasticsearch [URI parts processor](https://docs-v3-preview.elastic.dev/elastic/docs-builder/docs/3716/reference/ingest-processor/uri-parts-processor) internally, but you configure it in Streamlang. Streamlang doesn't always have 1:1 parity with the ingest processor options and behavior. Refer to [Processor limitations and inconsistencies](/elastic/docs-builder/docs/3716/solutions/observability/streams/streamlang#streams-processor-inconsistencies).

## YAML reference

In [YAML mode](/elastic/docs-builder/docs/3716/solutions/observability/streams/parse-and-process#streams-editing-yaml-mode), configure the URI parts processor using the following parameters. For the complete Streamlang syntax, refer to the [Streamlang reference](https://www.elastic.co/elastic/docs-builder/docs/3716/solutions/observability/streams/streamlang).

| Parameter              | Type    | Required | Description                                                                                                                      |
|------------------------|---------|----------|----------------------------------------------------------------------------------------------------------------------------------|
| `from`                 | string  | Yes      | Field containing the URI string to parse.                                                                                        |
| `to`                   | string  | No       | Target field / column prefix for the extracted URI components. Defaults to `url`.                                                |
| `keep_original`        | boolean | No       | When `true` (default), preserve the original URI string at `<prefix>.original`.                                                  |
| `remove_if_successful` | boolean | No       | When `true`, remove the source field after a successful parse. The source field is kept when parsing fails. Defaults to `false`. |
| `ignore_missing`       | boolean | No       | When `true`, skip this processor if the source field is missing.                                                                 |

```yaml
- action: uri_parts
  from: attributes.url.original
  to: attributes.url
```

Given a document with `attributes.url.original` set to `http://myusername:mypassword@www.example.com:80/foo.gif?key1=val1&key2=val2#fragment`, the processor adds:
- `attributes.url.scheme: "http"`
- `attributes.url.domain: "www.example.com"`
- `attributes.url.path: "/foo.gif"`
- `attributes.url.extension: "gif"`
- `attributes.url.port: 80`
- `attributes.url.query: "key1=val1&key2=val2"`
- `attributes.url.fragment: "fragment"`
- `attributes.url.user_info: "myusername:mypassword"`
- `attributes.url.username: "myusername"`
- `attributes.url.password: "mypassword"`