# `MishkaGervaz.Table.Entities.Filter.Preload`
[🔗](https://github.com/mishka-group/mishka_gervaz/blob/v0.0.1-alpha.3/lib/mishka_gervaz/table/entities/filter.ex#L333)

Preload configuration for relation filters.

Defines which relationships to load for display_field rendering,
with support for different preloads based on user type.

## Example

    filter :media_category_id, :relation do
      display_field fn r -> "#{r.name} - #{r.site.name}" end

      preload do
        always [:site]
        tenant [:category]
        master master_category: :category
      end
    end

# `preload_spec`

```elixir
@type preload_spec() :: atom() | {atom(), atom()} | list()
```

# `t`

```elixir
@type t() :: %MishkaGervaz.Table.Entities.Filter.Preload{
  __spark_metadata__: map() | nil,
  always: [preload_spec()] | nil,
  master: [preload_spec()] | nil,
  tenant: [preload_spec()] | nil
}
```

# `transform`

---

*Consult [api-reference.md](api-reference.md) for complete listing*