pretix_original/doc/user/organizers/index.rst

Organizer accounts and teams
============================

Organizer account
-----------------

The basis of all your operations within pretix is your organizer account. It represents an entity that is running
events, for example a company, yourself or any other institution.
Every event belongs to one organizer account and events within the same organizer account are assumed to belong together
in some sense, whereas events in different organizer accounts are completely isolated.

If you want to use the hosted pretix service, you can create an organizer account on our `Get started`_ page. Otherwise,
ask your pretix administrator for access to an organizer account.

You can find out all organizer accounts you have access to by going to your global dashboard (click on the pretix logo
in the top-left corner) and then select "Organizers" from the navigation bar on the left side. Then, choose one of the
organizer accounts presented, if there are multiple of them:

.. thumbnail:: ../../screens/organizer/list.png
   :align: center
   :class: screenshot

This overview shows you all event that belong to the organizer and you have access to:

.. thumbnail:: ../../screens/organizer/event_list.png
   :align: center
   :class: screenshot

With the "Edit" button at the top, next to the organizer account name, you can modify properties of the organizer
account such as its name and display settings for the public profile page of the organizer account:

.. thumbnail:: ../../screens/organizer/edit.png
   :align: center
   :class: screenshot

.. tip::

   The profile page will be shown as ``https://pretix.eu/slug/`` where ``slug`` is to be replaced by the short form of
   the organizer name that you entered during account creation and ``pretix.eu`` is to be replaced by your
   installation's domain name if you are not using our hosted service.

   Instead, you can also use a custom domain for the profile page and your events, for example
   ``https://tickets.example.com/`` if ``example.com`` is a domain that you own. In this case, please contact the pretix
   hosted support or your system administrator to set up the custom domain.

Teams
-----

We don't expect you to work on your events all by yourself and therefore, pretix comes with ways to invite your fellow
team members to access your pretix organizer account. To manage teams, click on the "Teams" link on your organizer
settings page (see above how to find it). This shows you a list of teams that should contain at least one team already:

.. thumbnail:: ../../screens/organizer/team_list.png
   :align: center
   :class: screenshot

If you click on a team name, you get to a page that shows you the current members of the team:

.. thumbnail:: ../../screens/organizer/team_detail.png
   :align: center
   :class: screenshot

You see that there is a list of pretix user accounts (i.e. email addresses), who are part of the team. To add a user to
the team, just enter their email address in the text box next to the "Add" button. If the user already has an account
in the pretix system they will instantly get access to the team. Otherwise, they will be sent an email with an invitation
link that can be used to create an account. This account will then instantly have access to the team. Users can be part
of as many teams as you want.

In the section below, you can also create access tokens for our :ref:`rest-api`. You can read more on this topic in the
section :ref:`rest-auth` of the API documentation.

Next to the team name, you again see a button called "Edit" that allows you to modify the permissions of the team.
Permissions separate into two areas:

* **Organizer permissions** allow actions on the level of an organizer account, in particular:

   * Can create events – To create a new event under this organizer account, users need to have this permission

   * Can change teams and permissions – This permission is required to perform the kind of action you are doing right now.
     Anyone with this permission can assign arbitrary other permissions to themselves, so this is the most powerful
     permission there is to give.

   * Can change organizer settings – This permission is required to perform changes to the settings of the organizer
     account, e.g. its name or display settings.

* **Event permissions** allow actions on the level of an event. You can give the team access to all events of the
  organizer (including future ones that are not yet created) or just a selected set of events. The specific permissions to choose from are:

   * Can change event settings – This permission gives access to most areas of the control panel that are not controlled
     by one of the other event permissions, especially those that are related to setting up and configuring the event.

   * Can change product settings – This permission allows to create and modify products and objects that are closely
     related to products, such as product categories, quotas, and questions.

   * Can view orders – This permission allows viewing the list of orders and allindividual order details, but not
     changing anything about it. This also includes the various exports offered.

   * Can change orders – This permission allows all actions that involve changing an order, such as changing the products
     in an order, marking an order as paid or refunden, importing banking data, etc. This only works properly if the
     same users also have the "Can view orders" permission.

   * Can view vouchers – This permission allows viewing the list of vouchers including the voucher codes themselves and
     their redemption status.

   * Can change vouchers – This permission allows to create and modify vouchers in all their details. It only works
     properly if the same users also have the "Can view vouchers" permission.

.. thumbnail:: ../../screens/organizer/team_edit.png
   :align: center
   :class: screenshot

.. _Get started: https://pretix.eu/about/en/setup