17 Settings and organization management
← Technical Guide

Section 17

Settings and organization management

Describes the settings screens where you manage organization information, members, roles, modules, the subscription and your own account, as well as the notification, file, usage and feedback screens.

What this chapter covers

This chapter describes organization and account settings and the shared screens that are not tied to modules. These screens are not a module opened by license; every user who is a member of the organization reaches the settings. The actions on the screens, however, require separate permissions; each part states which permission is required.

  • On desktop, the Settings page opens from the user menu at the top right with «General settings». The same menu has «Sign out».
  • The bell in the top bar opens the Notifications screen and shows the number of unread notifications.
  • On mobile, in the «Account & settings» section at the bottom of the menu, there are these links: Notifications, Files, Activity log, Members, Organization, Features, Subscription, Profile, API keys and Webhooks.
  • The command palette (Cmd/Ctrl+K) gives quick access to the screens in the «Pages» and «Settings» groups. When you type at least two characters, it also searches among the organization’s members, files and operation records.

The concepts of roles, invitations and licenses are described in Chapter 1; data import, data sources and mapping in Chapter 2; operation records, API keys and webhooks in Chapter 3. This chapter does not repeat those topics; it introduces the relevant screen and gives a reference.

Settings

The page title is «General settings». The settings screens are listed as cards in three groups; when you click a card, the relevant screen opens. The page itself requires no permission.

GroupCardIn this guide
OrganizationOrganizationThis chapter, «Organization»
OrganizationMembersThis chapter, «Members»
OrganizationRoles & permissionsThis chapter, «Roles»
OrganizationBrand & appearanceThis chapter, «Brand»
OrganizationModulesThis chapter, «Features»
OrganizationSubscription & invoicesThis chapter, «Billing»
Developer & dataAPI keysChapter 3
Developer & dataWebhooksChapter 3
Developer & dataImport dataChapter 2
Developer & dataMapping studioChapter 2
Developer & dataSource dashboardChapter 2
AccountProfileThis chapter, «Profile»
AccountSecurityThis chapter, «Security»

Organization

In the «Organization settings» screen you edit your organization’s information: logo (JPG, PNG or WebP, at most 5 MB), Organization name (at least 2 characters), Sector, Country, Language and Time zone. The organization ID is shown but cannot be changed. The «Save» button becomes active only when a field has changed.

  • The Time zone determines which day «today» falls on in the Reports, Management today and Business Health screens.
  • The interface language comes not from the Language field in this form but from the user’s own choice; it is described in Chapter 1.
  • Uploading a logo requires the settings.update permission, and saving organization information requires the organization.update permission.
  • In the «Custom domain» card, a domain name is registered for your organization; the organization owner or administrator can do this. As the «No verification» badge next to the registered domain name says, the domain name is not verified.
  • Only the organization owner can perform «Delete organization» in the «Danger zone»; to confirm, you are asked to type the organization’s name. An organization in a trial period or a locked one is deleted only with the approval of the PULS team. Deletion marks the organization record as deleted.

Members

The screen lists the organization’s members and invitations. The member.read permission is required to view it; a user without the permission is told the name of the required permission. The top row shows the numbers of members, pending invitations and expired invitations. Each member shows name or email, role and join date. «Download CSV» exports the member list. If there are no members yet, the screen states this.

  • With «Invite» you create an invitation by choosing an email address and a role (member.invite permission). The organization owner role is not in this list.
  • When an invitation is created, the invitation link is shown on the screen and an attempt is made to send the invitation email. If the email cannot be sent, the screen reports this with a warning; you can take the link with «Copy» and pass it to the invitee yourself.
  • In the «Pending invitations» list, the status of each invitation (Pending or Expired) is shown. You can copy the link of a pending invitation or cancel the invitation. The link of an expired invitation does not work; you cancel the invitation and invite again.
  • «Remove member» requires the member.remove permission; you cannot remove yourself.

Roles

In the «Roles and permissions» screen, each role in the organization appears as a card: its name, whether it is a system role, how many permissions it carries, and the list of permissions. The «Available permissions» card groups all permissions in the application by module. If there is no role yet, the screen states this.

  • With «New Role», a role is created by selecting a key (lowercase letters, digits and underscore), role name, description and permissions.
  • In the organization’s own roles, «Edit» changes only the permissions; the key and name cannot be changed afterwards.
  • «Delete» removes the role; the role of members assigned to that role becomes empty. Confirmation is requested before deleting.
  • Creating, editing and deleting require the member.update_role permission. System roles cannot be edited or deleted; this is described in Chapter 1.

Features

It is opened from the «Modules» card on the Settings page. In the «Available features» list, each module’s name, key, description and Active or Inactive status appear; the badge in the header gives the number of active features. The button on a row turns the feature on or off and requires the feature.activate permission. If there is no defined feature yet, the screen states this.

Security

The «Security» screen shows the state of your own account: whether your email address is verified, whether two-factor authentication is on, your last sign-in time and, if any, your linked accounts.

  • «Sign out of all devices» in the «Session management» section, after your confirmation, closes your sessions on all devices and takes you to the sign-in page.
  • Changing the password and turning on two-factor authentication are not on this screen but on the «Profile» screen.

Billing

It is opened under the name «Subscription» or «Subscription & invoices» in the menus; the page title is «Subscription». The «Current plan» card shows your plan’s name and status (Trial, Active, Payment overdue or Paused), period end, user limit and storage space. If there is no subscription, the screen states this.

  • If usage counters are kept for your organization, the «Usage» card shows the value of each counter and, if any, its limit.
  • In the «Plans» cards, each plan’s name, user limit and storage space are written; your current plan is marked with the «Current» badge.
  • The «Manage subscription» button and the button on the other plan cards direct you to the payment and subscription page. If the redirect address cannot be obtained, the screen shows an error warning.

Brand

In the «Brand settings» screen you enter Primary color, Secondary color (in #rrggbb format) and an Email footer of at most 500 characters; «Email preview» shows the result. Saving requires the settings.update permission.

The primary color, organization logo and footer are used in invitation emails sent from your organization. The logo is uploaded from the «Organization» screen.

Profile

«Profile settings» belongs to your own account. In the «Personal information» section, the profile photo (at most 5 MB), full name and phone are updated.

  • In the «Change password» section you enter the new password (at least 8 characters) twice.
  • In the «Security — 2FA» section, you scan a QR code with your authenticator app or type the manual entry code, and turn verification on with the code generated by the app. You can turn off verification that is on from the same section.
  • In the «Email notifications» section, preferences are saved for Member Invitations, New Members, Member Removal, File Uploads, Subscription Changes and Security Alerts. The preferences are saved to your account; the emails the application sends are not filtered according to these preferences.

Audit logs

This screen lists who did what in your organization; in the menus and the command palette it is opened under the name «Activity log». The screen’s columns, who can see it, and export are described in Chapter 3.

Notifications

The screen shows the last 50 notifications that came to you; the header shows the number of unread notifications. Notifications are produced by modules. New notifications that arrive while the page is open are added to the list without refreshing the page. If there are no notifications yet, the screen states this.

  • Each row shows the notification’s title, its text and short summary if present, and how long ago it arrived. When you click a notification whose related screen is known, that screen opens and the notification is counted as read; for the others, a click only marks it as read.
  • If there are unread notifications, «Mark all as read» makes them all read.

Files

The «All files» list shows the organization’s total file count and the newest 50 files: File, Size, Uploaded by, Date and Visibility. Visibility is «Within organization» for every file: all members of the organization can see the file. The «Storage usage» row compares the total size of the files shown in the list with your plan’s storage limit. If there are no files yet, the screen states this.

  • «Upload file» requires the file.upload permission; a single file can be at most 50 MB and the plan’s storage limit cannot be exceeded.
  • The download button opens the file in a new tab through a link valid for a short time. Files are not served from an address open outside the organization.
  • The delete button asks for confirmation and requires the file.delete permission. «Download CSV» exports the file list and requires the file.read permission.

Usage

The «Usage & analytics» screen is not in the menu; its address is /app/usage. Four cards show the number of active members, the total number of files, the number of active API keys and the number of active webhooks; below the member and file cards, the number added in the last 7 days is shown.

  • «Plan quota» compares the number of members and the storage space used with your plan’s limits. If there is no subscription, it states this.
  • «Recent activity» lists the last 10 operations in the organization. If there are no operations yet, it states this.

Feedback

This screen is not in the menu; its address is /app/feedback. The feedback sent by your organization’s members, at most 50 items, is sorted by vote count and date; the sender’s name is not shown. The list can be filtered by type: All, Feature Request, Bug Report, General, Other. If there is no feedback yet, the screen states this.

  • In the form opened with «New», you choose a type, write a title (5–200 characters) and a description (10–5000 characters), and submit.
  • Each record has a vote button; a second click withdraws your vote.
  • Each record’s status is shown with a badge: Open, Reviewed, Planned, Completed or Rejected.
  • Every user who is a member of the organization sees this screen and can send feedback; no separate permission is required.

Help

The «Help & support» screen is not in the menu; its address is /app/help. The screen has resource cards and frequently asked questions. The «API reference» card opens the API keys screen; the «Support» card and the «Can't find what you're looking for?» section at the bottom of the page let you write an email to the support address.

Awaiting Approval

If your access request has not yet been decided, the application brings you to this page. The page shows the status of your organization’s latest request:

StatusWhat you see
PendingThe notice that the request has arrived and the list of modules you requested
ApprovedThe list of enabled modules and the button to enter the application
Not enabledThe notice that the request is not enabled at the moment, and the contact address
No requestsThe notice that no pending request is visible, the contact address and a link to switch to the application
Could not be readThe notice that the status could not be read (this is not a decision but a system error), the contact address and a link to switch to the application

The access request, approval and approval e-mail are described in Section 1.