# single\_value

The `single_value` formatter plugin output the value of a single field instead of the whole record.

This formatter is often used in conjunction with [`none` parser](https://docs.fluentd.org/parser/none) in input plugin.

## Parameters

* [Common Parameters](https://docs.fluentd.org/configuration/plugin-common-parameters)
* [Format section configurations](https://docs.fluentd.org/configuration/format-section)

### `add_newline`

| type | default | version |
| ---- | ------- | ------- |
| bool | `true`  | 0.14.0  |

Adds `\n` to the result. If there is a trailing `\n` already, set it `false`.

### `message_key`

| type   | default | version |
| ------ | ------- | ------- |
| string | message | 0.14.0  |

The value of this field is outputted.

### `newline`

| type | default                                        | version |
| ---- | ---------------------------------------------- | ------- |
| enum | `lf (for non-Windows)` or `crlf (for Windows)` | 1.11.5  |

Specify newline characters.

## Example

```
tag:    app.event
time:   1362020400
record: {"message":"Hello from Fluentd!"}
```

This incoming event is formatted to:

In non-Windows:

```
Hello from Fluentd!\n
```

In Windows:

```
Hello from Fluentd!\r\n
```

If this article is incorrect or outdated, or omits critical information, please [let us know](https://github.com/fluent/fluentd-docs-gitbook/issues?state=open). [Fluentd](http://www.fluentd.org/) is an open-source project under [Cloud Native Computing Foundation (CNCF)](https://cncf.io/). All components are available under the Apache 2 License.