---
title: Friends
description: "--- ###### Elements supports the concept of Friends between two users, which establishes a relationship that offers more engagement, such as viewing Leaderboard rankings or viewing each other's [Profile](https://namazustudios.com/glossary/profile/) details. Elements supports the concept of Friends between two Users. Friends…"
url: "https://namazustudios.com/docs/namazu-elements-core/friends/"
updated: "2026-08-13"
category: Namazu Elements Core Features
---

# Friends

---

###### Elements supports the concept of Friends between two users, which establishes a relationship that offers more engagement, such as viewing Leaderboard rankings or viewing each other's [Profile](https://namazustudios.com/glossary/profile/) details.

Elements supports the concept of Friends between two Users. Friends are created at the [User](https://namazustudios.com/glossary/user/) level and not at the [Profile](https://namazustudios.com/glossary/profile/) level. When two users are Friends, they have the following privileges.

- Friends may view [Leaderboard](leaderboards) rankings relative to other friends.
- Friends may view each other's [Profiles](users-and-profiles) associated with their account.
- When one [User](https://namazustudios.com/glossary/user/) views a [User](https://namazustudios.com/glossary/user/) through a Friend, Elements will intentionally hide personal information.
- Cloud Functions may perform friend checks and alter the behavior as the Friend API is fully exposed to the scripting engine.

Elements models Friends as a bi-directional relationship between two [Users](users-and-profiles). The Friend model contains the following properties:

- [**[id](https://namazustudios.com/glossary/id/)**](../../general/general-concepts#id-property)
- **[User](https://namazustudios.com/glossary/user/)**: The [User](users-and-profiles) which is the other friend. This contains limited information on the [User](https://namazustudios.com/glossary/user/) as some of it may be personally identificable.
- **profiles**: The [Profiles](users-and-profiles) of the other [User](https://namazustudios.com/glossary/user/).
- **friendship**: Indicates the kind of friendship between the Users, based on any of these options below.
- **NONE**: There is no association between the users. This is used internally and APIs should almost never use this value.
- **OUTGOING: T**he logged-in [User](https://namazustudios.com/glossary/user/) has requested friendship from the other [User](https://namazustudios.com/glossary/user/)
- **INCOMING**: The other [User](https://namazustudios.com/glossary/user/) has requested friendship from the currently logged-in [User](https://namazustudios.com/glossary/user/)
- **MUTUAL**: Both users have accepted friendship.

### Automatic Facebook Friends [#automatic-facebook-friends](#automatic-facebook-friends)

When two Users connect with Facebook, Elements will automatically scan their friends list and mirror that association within Elements. This behavior is hardcoded in the [Facebook](applications/facebook-application-configuration) workflow and cannot be disabled. Each new Facebook [Session](https://namazustudios.com/glossary/session/) forces a refresh of the friends list.

### Associating Friends [#associating-friends](#associating-friends)

You must use [authoritative](https://namazustudios.com/glossary/authoritative/) code to make Friend associations. This ensures that your game or [Application](https://namazustudios.com/glossary/application/) can make friend associations using the rules of your [Application](https://namazustudios.com/glossary/application/).