Organizations

Managing the organizations on your domain

Overview

An organization is a way to categorize users for administration & management purposes. If you are a holding company that is a collection of multiple companies, you can consider creating an organization for each company. Assign an admin to each organization who then will have the privileges to perform user administration & management tasks for the users who are part of the organization.

Admin Portal > Users > Organizations
  1. Organizations: List of organizations and their hierarchy on your domain. The default organization is the single, top-level node. All other organizations you create become the “child” (sub-organization) nodes of the default organization. For example, a parent company might own 3 organizations with distinct internet domain names like help-docs.com, child1.help-docs.com & child2.help-docs.com, which can be modeled as 3 organizations under one MangoApps domain.

    The MangoApps Domain URL is uniquely tied to the default organization. No other sub-organization can be created using the same domain. All child organizations must use a different domain URI.

  2. Type of organization: You can select your domain to have either type 1 or type 2 organization structure.

    1. Type 1 - Open Organization: This is the default option. Companies primarily use it to delegate user admin roles. This feature lets companies divide employees into multiple buckets and assign one or more administrators to manage the users of each bucket. Select this option if you:

      1. Do NOT want to restrict users of one organization from following or messaging users of other organization,

      2. Want content of one organization be accessible to members of other organizations.

    2. Type 2 - Walled Organization: Exactly the same as Type 1, except it offers extra security via its “Chinese Wall” feature — which restricts the passage of information and communication between separate organizations. Select this option if you want:

      1. To restrict users of one organization from following or messaging users of other organization,

      2. Content to be accessible only to organization members.

      If selected, a user can belong to multiple organizations where one organization is the primary and the other organizations are secondary.

      The primary organization decides which organization admin is going to manage the user.

      See Different organization structures in FAQs for more information.

  3. Label for Organization: The text used for the default organization label. You can use "company" or any other text as the organization label.

  4. Organization Name: Unique name that identifies the organization on your domain. Mostly seen in the users' list in the Manage Users tab.

  5. Organization Domain: Your company’s unique URL to access MangoApps. In most cases, it is formed from the portion after the “@" sign in your user’s company email address. For example, if you signup with john@help-docs.com it becomes help-docs.mangospring.com (on US data center) or help-docs.mangoapps.com (on any of the 4 international data centers). Another example is, if you signup with john@stateuniversity.edu, it becomes stateuniversity.mangospring.com (on US data center) or stateuniversity.mangoapps.com (on any of the 4 international data centers).

    This domain URL is customizable for all our private cloud & on-premise customers. This domain also becomes the top level Organization in MangoApps.

    The organization domain acts as the parameter for rerouting user invitation approvals to the network admins and organization admins (Admin Portal > Domain > General Settings > Invite, Signup & Login Settings > Employees to invite other employees > Moderated > Approvals are first routed to the organization admin based on user's domain email).

  6. Organization Admin: Specifies the organization administrators who have permissions to manage users belonging to the organization. Organization admins can approve new user invite requests, reset passwords, deactivate users, etc. They CANNOT delete users. See Admin Roles for more information. Organization admins do not themselves need to belong to the organization they manage. There can be multiple organization admins for one organization.

  7. Number of Seats Allocated: Allocated number of users that can be activated to use MangoApps per organization. More than the number of seats can be assigned, but only the number of seats specified can be activated at once. If you’ve activated the maximum number of seats, you must first deactivate some of the existing seats before new seats can be activated. Leaving the field blank indicates that unlimited users can be allowed in this organization.

  8. Allow Creation of Groups by Organization Members: If enabled, allows only the members of the organization to create groups.

  9. Parent Organization: Specifies whether the organization can have “child” (sub-organizations).

  10. Save Changes: Click the Save Changes button to save the modifications to the settings.

Switching from Type 1 - Open Organization to Type 2 - Walled Organization mid-project is NOT RECOMMENDED since it results in a serious impact on the visibility of the teams' data for the users of the organizations and requires the network admin to reassign the teams to each user manually.

Adding Organizations

You can add "child" (sub-organizations) to the default top-level organization. A sub-organization can have sub-organizations if it the Parent Organization checkbox is marked for it. To add organizations:

  1. Click the Actions () button for the preferred organization and then click Add child organization.

  2. Enter the name for the organization in the Organization Name text box. For example, enter "Child Organization 2".

  3. Enter the domain for the organization in the Organization Domain text box. For example, enter "child2.help-docs.com".

  4. Add the admins for the organization in the Organization Admins text box. This is an optional step.

  5. Enter the number of seats allowed for the organization in the Number of Seats Allocated text box. This is an optional step.

  6. Mark the Allow Creation of Groups by Organization Members checkbox to allow only members of the organization to create groups. This is an optional step.

  7. Mark the Parent Organization checkbox to allow the organization to have "child" (sub-organizations).

  8. Click the Save Changes button.

  9. Repeat steps 1 through 8 to add more "child" organizations on your domain.

Adding organizations

Only network admins can create organizations in the domain.

Deleting Organizations

To delete an organization:

  1. Click the Actions () button for the preferred organization and then click the Delete option.

Deleting an organization does NOT delete the members of the organization.

You CANNOT delete the default organization (first node).

Reordering Organizations

You can move an organization to organizations which have been allowed to have "child" (sub-organizations). To reorder organization:

  1. Click the Actions () button for the preferred organization and then click the Move option.

  2. In the Move Organization pop-up, select the preferred organization and then click the Move button.

Reordering organizations

You can move a group of organization which has sub-organizations into another parent organization.

FAQs

How are organizations different from departments?

Departments manifest themselves in the User Portal and typically resemble your company departments like finance, hr, operations whereas organizations do NOT appear in the User Portal and can be entirely different from your company structure.

Does the organizational hierarchy restrict data between defined organizations?

MangoApps type 2 organization restricts sharing of data between users who don't share a common organization.

What is a “parent” organization?

A “parent” organization is one that is allowed to have "child" organizations (or sub-organizations). The default organization is, by default, a “Parent” organization.

How can companies collaborate by choosing the different organization structures in MangoApps?

The MangoApps platform offers two approaches for managing multiple subsidiary companies (referred to as "Organizations" in MangoApps) for collaboration - Type 1 Open Organization and Type 2 Walled Organization. You can choose the organization structure based on your company-specific needs.

1. Type 1 - Open Organization

With this type, when you provision user accounts (either by inviting users or by integrating with Active Directory) the users in the domain get assigned to an organization based on their email address automatically. This makes the organization setup fast and simple. As a network admin, you can change the user’s organization at any time.

Under this option:

  • A user can only belong to 1 or more organizations.

  • Organization admin for the organization and the network admin is responsible for user administration.

  • Parent organization admin can administer child organization users as well.

  • A user from one organization can follow any user from any other organization.

  • All content visibility is by default at the full company level. Further granular control to access content can be achieved by creating departments, projects, and groups within which fine-grained access rights can be setup for updates, files, wikis, posts, events, etc.

Type 1 - Open Organization

2. Type 2 - Walled Organization

When you provision user accounts (either by inviting users or by integrating with Active Directory) the users in the domain get assigned to a “Primary” organization based on their email address automatically (just like in the first option). This will make your setup fast & simple — although this organization management option will get a bit trickier down the road. As a domain admin, you can change the user’s organization at any time or add more organizations.

Under this option:

  • A user can belong to multiple organizations.

  • A user can have 1 Primary Organization and multiple Secondary Organizations.

  • Organization admin of the Primary Organization and the network admin is responsible for the user’s administration.

  • Parent Organization admin can administer child organization users as well.

  • A user from one organization can follow a user only if they share an organization. This limits the users in the domain you can follow.

  • All content visibility is, by default, limited to the user's organizations (Primary + Secondary). For the user to have visibility to particular content, he MUST to be a part of the organization in which the content belongs to — even if the content is public. Once the user is part of the organization — then within the organization, further access is governed by the same rules as the above option.

  • A user’s Primary Organization only determines the user's organization admins. The Primary and Secondary Organizations together determine the public content that the user has access to.

Type 2 - Walled Organization

Did this article help? Your feedback adds value when we shape up the help articles. Hit the smileybelow to let us know!