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

# Adoption and Governance

> Centrally control FlowForma environment creation, process movement between environments, usage reporting, and site customizations across a site collection

The Adoption and Governance feature in FlowForma controls the creation of FlowForma environments, manages the movement of processes between environments, and displays reports on process usage. It also lets you manage site themes, user groups, and customizations centrally for all sites in a site collection.

It consists of the following:

* **[Environments Hub](/product/adoption-and-governance/environments-hub)**: allows the creation and management of FlowForma app requests
* **Process Hub**: allows the creation and management of process promotion requests between environments
* **Usage & Statistics**: view built-in reports for forms started, completed, and overdue for the past year, broken down by month and by user
* **[Adoption Hub](/product/adoption-and-governance/adoption-hub)**: provides a central management location for customizations, for example you can deploy add-on questions/rules to all apps, or use the same form theme/company branding for all forms
* **[Licensing Hub](/product/adoption-and-governance/licensing-hub)**: manage licensing for sites and users, as well as feature activation and usage reports using cost centers

<Info>
  **Before installing the Governance webpart**

  If you have not yet deployed any FlowForma apps on your SharePoint tenant you must deploy one manually from the SharePoint store, this will apply the required permissions to SharePoint for apps that are subsequently created using Governance.

  This step is not required if you have already installed at least one FlowForma app from the SharePoint store.
</Info>

## Permissions

#### User Permissions

Adoption and Governance includes two permission levels:

1. **Governance User**
   * Can view the Environments and Process hubs.
   * Can request new environments and process promotions, with permission to approve them.
   * All FlowForma users are considered Governance users.
2. **Governance Administrator**
   * Has access to all hubs, can request and approve requests, and can manage licensing for users and sites.

To become a Governance Administrator, a user must meet these criteria:

* Their O365 account must have the SharePoint Administrator or Global Administrator role.
* The Adoption and Governance site collection(s) must either:
  * Add the "SharePoint Service Administrator" as a Site Collection Administrator (allowing anyone with the SharePoint Administrator role to have admin permissions), or
  * Individually assign admin permissions to users with the Global Administrator or SharePoint Administrator role.

#### App Permissions

<Info>
  To grant permissions for Governance to create apps or promote processes, a Global Administrator must accept the first New environment request or Process promotion request.
</Info>

<img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/overview/adoption-and-governance-overview-1.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=6cd56edb553a154e1a94402eff7043b1" alt="Governance web part Login button" width="367" height="380" data-path="images/product/adoption-and-governance/overview/adoption-and-governance-overview-1.png" />

Click the Login button and the screen below is displayed.

<img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/overview/adoption-and-governance-overview-2.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=390db71f78eae5fdc9e493160c0271b7" alt="Microsoft consent screen with the 'Consent on behalf of your organization' checkbox" width="485" height="660" data-path="images/product/adoption-and-governance/overview/adoption-and-governance-overview-2.png" />

Check the "Consent on behalf of your organization" checkbox, then click Accept.

Permissions are now granted to Governance, so SharePoint Administrators can approve New Environment requests and Process Promotion requests.

Alternatively, you can achieve the same result by editing the Governance web part and logging in there.

<img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/overview/adoption-and-governance-overview-3.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=89f0492f62f0575c541ada0ee5cae008" alt="Login button when editing the Governance web part" width="250" height="474" data-path="images/product/adoption-and-governance/overview/adoption-and-governance-overview-3.png" />

Click the Login button and the screen below is displayed.

<img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/overview/adoption-and-governance-overview-4.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=e07eeb602b1b59917e7fd47aee3803f4" alt="Consent screen reached by editing the Governance web part" width="361" height="508" data-path="images/product/adoption-and-governance/overview/adoption-and-governance-overview-4.png" />

Check the "Consent on behalf of your organization" checkbox, then click Accept.

## Set up

The Adoption and Governance web part is optimized for "site pages".

To start, create a new site page.

<img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/overview/adoption-and-governance-overview-5.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=4daaae8d7541644bb221b98079aee121" alt="Creating a new SharePoint site page" width="1294" height="501" data-path="images/product/adoption-and-governance/overview/adoption-and-governance-overview-5.png" />

Navigate to the new page, edit it, then add a new web part and select FlowForma Governance.

<img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/overview/adoption-and-governance-overview-6.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=1ff52c174712add8293096107046c82e" alt="Adding the FlowForma Governance web part to the page" width="848" height="765" data-path="images/product/adoption-and-governance/overview/adoption-and-governance-overview-6.png" />

Once added, the web part is displayed, and you can publish the changes to your page.

<img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/overview/adoption-and-governance-overview-7.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=1d57106b70547179b3b0303d18a7444b" alt="FlowForma Governance web part displayed on the published page" width="1269" height="569" data-path="images/product/adoption-and-governance/overview/adoption-and-governance-overview-7.png" />
