# Users

Attach users to your content to show authorship, list team members, assign the winners of a foot race, or even winners of an elbow race.


## Overview

The most common use for the Users fieldtype is to set the "author" for entries, but it's not the only use. You could...

- List people who contributed to a project
- Link to related authors
- Manage an "Employee of the Weekend" section. Everyone wants to be the King or Queen of Inventory Saturday, right?
- Display team bios
- Pull in customer's testimonials through their user account.

## Data Structure

The Users fieldtype is a [relationship fieldtype](/extending/relationship-fieldtypes.md) – which mean the data will store a reference to the users IDs to main a dynamic link.

```yaml
author: abc-123-cba-321
```

## Templating

All relationship fields use [augmentation](/augmentation.md) to fetch the actual data objects, allowing you to interact with the related data automatically and dynamically.

The following example assumes `max_items` has been set to `1`.

:::hint
When `max_items: 1`, the field augments directly to the related user so you can use dot/colon notation (`{{ author:name }}`). If you'd rather always get a query builder back — so you can chain scopes or filters — enable [`always_augment_to_query`](/augmentation.md#always-augment-relationships-to-a-query).
:::

::tabs

::tab antlers
```antlers
<div class="bg-white p-4 shadow flex items-center">
{{ author }}
  <img class="w-10 h-10 rounded-full" src="{{ avatar }}" alt="Avatar of {{ name }}">
    <div class="text-sm ml-4">
      <p class="text-gray-900 leading-none">{{ name }}</p>
      <p class="text-gray-600">{{ email }}</p>
    </div>
{{ /author }}
</div>
```
::tab blade
```blade
<div class="bg-white p-4 shadow flex items-center">
	<img class="w-10 h-10 rounded-full" src="{{ $author->avatar }}" alt="Avatar of {{ $author->name }}">
	<div class="text-sm ml-4">
		<p class="text-gray-900 leading-none">{{ $author->name }}</p>
		<p class="text-gray-600">{{ $author->email }}</p>
	</div>
</div>
```

::

```html
<div class="bg-white p-4 shadow flex items-center">
  <img class="w-10 h-10 rounded-full" src="/img/avatars/david.jpg" alt="Avatar of David Hasselhoff">
    <div class="text-sm ml-4">
      <p class="text-gray-900 leading-none">David Hasselhoff</p>
      <p class="text-gray-600">thehoff@statamic.com</p>
    </div>
</div>
```
