# Using the sources in the builder

## Assigning a source

1. Open the page in the YOOtheme builder and select the element that is to show the contacts – a grid for a team, for example.
2. In an element with several items (grid, list, slider), select the **item** and choose the source *Contacts* under *Dynamic Content*. The builder then repeats the item for every contact.
3. For an element with exactly one contact, choose the source *Contact*.
4. Map the fields of the element to the fields of the contact – title to *Name*, image to *Image*, meta to *Contacts Position* and so on.

## Contacts

This source returns several contacts. All filters can be combined; empty filters do not restrict.

<table id="bkmrk-filter-by-categories"> <tbody> <tr><td>**Filter by Categories**</td><td>Multiple choice of the contact categories. The operator decides whether the selected categories must match or are excluded; below it you choose whether child categories are included, excluded or count alone.</td></tr> <tr><td>**Filter by Tags**</td><td>Multiple choice. "Match one", "match all" or "don't match"; child tags as well.</td></tr> <tr><td>**Filter by Featured Contacts**</td><td>All, featured only or not featured.</td></tr> <tr><td>**Filter by User Groups**</td><td>Only contacts whose linked user belongs to one of the selected groups.</td></tr> <tr><td>**Filter by Field**</td><td>A custom field of the contacts *is*, *is not* or *contains* a value. "Is not" also includes contacts without a value for the field.</td></tr> <tr><td>**Start and quantity**</td><td>How many contacts are skipped and how many are returned at most. Without a limit, at most 500.</td></tr> <tr><td>**Order**</td><td>Name, sort name (e.g. last name – the fields *Sort Name 1–3* of the contact, as in Joomla's category view), ordering of the contacts (as in the backend), created, modified, hits, random or a custom field. Plus the direction, *Alphanumeric Ordering* (numbers by value) and *Reverse Results*.</td></tr> </tbody></table>

## Contact

This source returns exactly one contact: the selected one or the *default contact* (marked as default in the backend). If a visitor may not see the contact, the element stays empty.

## Who sees which contacts

Both sources only show what a visitor would also see on Joomla's contact pages: published contacts in published categories, within their publishing window, in the visitor's access levels and, on multilingual sites, in the current language or "All".

<small>Applies to version 1.0.0.</small>

[Deutsche Fassung](https://docs.graup-it.de/link/473)