> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pagos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Your Pagos Organization

> Update your Pagos Organization and manage its members

After your business [subscribes to Pagos](https://pagos.ai/pricing), set up a Pagos **Organization** and [connect your payment processors](/importing-data/connecting-your-payment-processors-to-pagos). Your team can then create Pagos accounts, join your Organization, and log into the Service Panel to view your payments data.

<Warning title="Admins Only">
  This guide reviews how users with the **Admin** role can manage your Organization and its members.
</Warning>

## Managing General Settings

To manage your Organization's general settings:

<Steps>
  <Step>
    [Sign in](https://secure.pagos.ai/sign-in) to the Pagos Service Panel.
  </Step>

  <Step>
    Click the **settings** icon in the top-right corner of the Pagos Service Panel, then click **Settings** under your Organization's name. This opens a pop-up with your Organization's information.
  </Step>

  <Step>
    In the **General** page, click **Update Profile** to add or change your Organization name and logo.
  </Step>

  <Step>
    Click **Add domain** to [add a verified domain](#adding-a-verified-domain) to your Organization.
  </Step>
</Steps>

## Adding a Verified Domain

If your business has a verified domain, you can add it to your Pagos Organization. To add a verified domain:

<Steps>
  <Step>
    Click the **settings** icon in the top-right corner of the Pagos Service Panel, then click **Settings** under your Organization's name.
  </Step>

  <Step>
    In the **Verified domains** section of the **General** page, click **Add domain**.
  </Step>

  <Step>
    Enter your domain, then click **Save**.
  </Step>

  <Step>
    Enter your email address at that domain, then click **Save**. You'll receive an email to verify the domain for your Pagos Organization.
  </Step>
</Steps>

### User Enrollment with Verified Domains

After you set up a verified domain, turn on Automatic Suggestions to make it easier for users with email addresses on that domain to join your Pagos Organization. To turn this on, click the **...** icon beside your verified domain, then click **Manage**.

<Frame>
  <img src="https://mintcdn.com/pagossolutionsinc/5EFeXnDHI3X9pHx_/images/verified_domain.png?fit=max&auto=format&n=5EFeXnDHI3X9pHx_&q=85&s=c986a628344f1a65fc5fdca06ba8717b" alt="Verified Domain" width="1549" height="1280" data-path="images/verified_domain.png" />
</Frame>

You have two options:

* **No automatic enrollment** - Regardless of the user's email address domain, they can only join your Pagos Organization via an [email invitation](#inviting-new-members).
* **Automatic suggestions** - When a user with an email address on your verified domain manually signs up for a Pagos account, they'll have the option to join your Organization automatically. See our [New User Onboarding Guide](/getting-started/new-user-onboarding-guide#create-an-account-and-join-an-existing-organization) for details on how this looks for a new user on your verified domain. An **Admin** in your organization will [manage requests to join your Organization](#approving-member-requests).

## Managing Organization Members

You can manage which Pagos users have access to your Organization within the **Members** page of your Organization settings. To navigate directly to this page, click **Team** under your company name in the main **settings** menu.

The **Members** tab displays a list of Pagos users in your Organization and their role (Member or Admin). Each user has their own Pagos account with unique login credentials.

<Frame>
  <img src="https://mintcdn.com/pagossolutionsinc/5EFeXnDHI3X9pHx_/images/organization_members.png?fit=max&auto=format&n=5EFeXnDHI3X9pHx_&q=85&s=3e982a54a39e72826e9a32bee1e15e07" alt="Organization Members" width="1439" height="1196" data-path="images/organization_members.png" />
</Frame>

You can change a member's role at any time using the **Role** dropdown menu. To delete a user, click the **...** icon beside their email address, then click **Remove member**.

### Inviting New Members

To invite new users to join the organization:

<Steps>
  <Step>
    In the **Members** or **Invitations** tabs of the **Members** page, click **Invite**
  </Step>

  <Step title="Enter the user's email address">
    You can invite multiple members by adding each email address, separated by spaces or commas.
  </Step>

  <Step title="Set user roles">
    Use the **Role** drop-down menu to assign a role to the user(s):

    * **Members** can access the Pagos Service Panel
    * **Admins** can access the Pagos Service Panel, edit data connections, make changes to the Organization's settings, and manage members
  </Step>

  <Step title="Click Send invitations" />
</Steps>

We'll then send an email invitation to the user, prompting them to [activate their new Pagos account](/getting-started/new-user-onboarding-guide#accept-an-email-invitation).

### Approving Member Requests

To approve a request to join your Organization from an account with your [verified domain](#user-enrollment-with-verified-domains), navigate to the **Requests** tab of the **Members** Page. Beside the user's name, click **Approve**. Click **Reject** to deny the request.

## Customization Opportunities

Every merchant's business is different, and sometimes the standard set of filters and dimensions in Pagos don't capture what matters most to you or how you like to segment data. As such, we offer the following customization options:

* [MID hierarchies](#adding-a-custom-mid-hierarchy)
* [Metadata and soft descriptors](#adding-metadata-or-soft-descriptors)
* [Custom data dimensions](#adding-custom-dimensions)

### Adding a Custom MID Hierarchy

If your MIDs are organized into separate brands or business units, we can assist you in building out a custom hierarchy within the Pagos Insights platform. This allows your users to filter the entire Pagos Service Panel to only show data for the MIDs associated with an individual business unit. Admins in your organization can even restrict users by granting them visibility to only those business units they need access to.

Your business can be broken into up to **two** tiers; for example, if your business manages multiple brands globally, you could designate each brand with one tier and each country with your second tier. Work with your Pagos Account manager to establish the two tiers and all parameters within them.

Once established, you can map your MIDs into the tiers of your custom hierarchy:

<Steps>
  <Step>
    Click the **settings** icon in the top-right corner of the Pagos Service Panel.
  </Step>

  <Step>
    Under **Data Connections**, click **MID Mappings**.
  </Step>

  <Step>
    Click **Add Mapping Request** to open a side panel.
  </Step>

  <Step>
    Click the **Mapping** drop-down menu, then click the desired MID.
  </Step>

  <Step>
    Select your first tier parameter (per our example above, the brand), then select your second tier parameter (e.g. the country).
  </Step>

  <Step>
    Click **Submit**.

    <Warning>
      Once submitted, your MID mappings are locked in and can no longer be edited. Contact your Pagos Account Manager to request any changes to your MID mappings.
    </Warning>
  </Step>
</Steps>

### Adding Metadata or Soft Descriptors

If you [pass your own custom metadata or soft descriptors](/payments-basics/labeling-transactions-with-soft-descriptors-and-metadata) with individual transactions, Pagos ingests that information through your data connections. Alternatively, you can use the [Enrichment API](/data-ingestion-api/enrichment-api-overview) to add enhanced transaction metadata to all your payment events (e.g. transactions, refunds, disputes) ingested into Pagos from all of your connected processors.

You can then use our built-in [Metadata](/insights/insights-data-filters#metadata) and [Soft Descriptor](/insights/insights-data-filters#soft-descriptor) filters to view data in Pagos Insights for only those transaction with specific tags. The [Custom Data](/insights/custom-data) dashboard serves as a record of all ingested metadata and soft descriptors; you can even add plain-text [descriptions](/insights/custom-data#descriptions) of your custom data to ensure all Pagos users in your Organization know what each data field means.

### Adding Custom Dimensions

In Pagos Insights, you can create and filter data visualizations to break down your payments data however you want. Beyond the built-in options for segmenting payments data (e.g. by payment method, card brand, issuing bank, etc.), we can assist you in building out custom dimensions specific to your business, based on data you already send us.

For example, you can build custom dimensions to:

<AccordionGroup>
  <Accordion title="Segment by Metadata">
    Turn any [custom metadata field](#adding-metadata-or-soft-descriptors), such as payment channel, subscription type, or campaign name into a dimension. This can be especially helpful if different processors send the same information under different metadata field names (e.g. `payment_channel` on one processor and `processing_channel` on another); we can unify both into a single dimension.
  </Accordion>

  <Accordion title="Group Existing Filter Parameters">
    Define your own categories within existing [data filters](/insights/insights-data-filters#filter-options). For example, group issuing banks into "favorite" and "non-favorite."
  </Accordion>
</AccordionGroup>

Your custom dimensions appear in the following places:

* The **Dimensions** drop-down menu in [Charts](/insights/charts#dimensions)
* As a [filter option](/insights/insights-data-filters#your-custom-dimension) in **Charts**
* As a column option in the [Events table](/insights/events#column-options)
* Under **Custom Dimensions** on [Event Details pages](/insights/events#event-details-page)

<Note>
  **Keep in mind:**

  * You must work with your Pagos Account Manager to build out custom dimensions.
  * Custom dimensions can support up to 10,000 unique values per field.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.