Organizations

CityScreen Deals is multi-tenant. The organization is the isolation boundary: employees, deals, inventory, entity types, price lists, processes, and settings all belong to exactly one organization. Nothing is shared across organizations.

Creating an organization

Only a CityScreen platform administrator can create an organization. Creating an organization also creates:

  • The organization record.

  • The first employee account, marked as the organization’s main administrator.

  • A default administrator role with full permissions.

  • A root employee group.

  • The standard set of built-in entity types.

The main administrator can sign in immediately after creation.

Organization profile

The platform administrator sets the following on the organization profile:

  • Name — the display name of the organization.

  • Digital display synchronization — whether the display catalog is pulled from CityScreen Play.

  • Disk quota — the storage budget for uploaded files.

These settings are not accessible to the organization’s own administrators. Contact CityScreen support to request a change.

Enabling and disabling

A platform administrator can disable an organization. Disabling blocks new sign-ins: employees who try to sign in will be rejected.

A disabled organization also stops accepting personal access tokens, OAuth tokens and LDAP sign-ins.

Re-enabling the organization restores normal sign-in.

The administrator boundary

Two levels of administration exist:

  • Platform administrator — a CityScreen staff member who operates outside any single organization. This person creates organizations, sets the synchronization and quota flags, and enables or disables organizations.

  • Organization administrator — an employee inside the organization who configures settings, employees, groups, roles, and entity types.

Everything on this page describes platform-level operations. The rest of the administration section covers what the organization administrator manages.

For all three senses of the word "administrator" in CityScreen Deals, see terminology.