Avatars
=======

User avatars in Zammad can come from several sources. Whenever a new
avatar is fetched from any of them, the user's avatar is updated.
Already saved avatars are kept on the user, even if the configured
image service gets disabled afterwards.

Sources
-------

User avatars can be populated from any of the following sources.
Whichever source last fetched an avatar for a user becomes the active
one. The following sources are available:

- OAuth login providers (e.g. Microsoft, Google, GitHub) supply the avatar URL
  on sign-in when the provider exposes one. Zammad stores this URL on the user
  and fetches the image.
- The :doc:`Zammad Image Service </settings/system/services>` is used
  as a fallback for users with a valid email address (e.g. matching a
  Gravatar entry).
- Agents and customers can upload or capture a custom avatar image from their
  user profile.

.. note::

   :doc:`LDAP/Active Directory </system/integrations/ldap/index>`
   does **not** synchronize user avatars. Avatars for LDAP-sourced
   users come from the sources listed above instead.

Changing Avatars
----------------

Admins cannot change the avatar of a user. To change their own avatar, a user
has to change it in the **Avatar** section of their ``Profile`` and upload an
image or capture one with their webcam.