> ## 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 Hub

> Use the FlowForma Adoption Hub to apply default logos, colors, and form themes and to add, remove, or replace users across groups in chosen site collections.

The **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).

<img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/adoption-hub/adoption-hub-1.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=883d4adbdccb64d83e8cb0f9a5a9ead2" alt="The Adoption Hub tiles" width="722" height="175" data-path="images/product/adoption-and-governance/adoption-hub/adoption-hub-1.png" />

## Default logo and colors

This allows you to add an image to all the sites in a site collection and change the theme (the colors of various items on the page) of the forms created using FlowForma.

Click the **Default logo and colors** tile and the following screen is displayed.

<img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/adoption-hub/adoption-hub-2.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=1fc00f93f225f6f7203e52cbaba69d72" alt="Default logo and colors screen" width="885" height="629" data-path="images/product/adoption-and-governance/adoption-hub/adoption-hub-2.png" />

### Editable items

You can change the following items to control how your FlowForma form is displayed.

* **Logo URL**: enter the URL of the image you want to display at the top of your FlowForma form.
* **Theme**: select the theme you want to use on your FlowForma sites from this drop-down of available themes.
* **Step color**: the color used to display steps on your form.
* **Step background color**: the color used for the step background on your form.
* **Step font color**: the color used for the text displayed on the step tiles on your form.
* **Form background color**: the color used for the form background on your form.
* **Separator color**: the default color used for separator questions added to your form.

### Site collections

The changes you make will be applied to the site collection(s) you select from the list of site collections on the right of the screen.

To select a site collection, check the checkbox next to the site collection you require. You must select at least one site collection, but you can select multiple if you wish.

<img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/adoption-hub/adoption-hub-3.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=f3f02e65f962ace5824ebbbec25151a6" alt="Selecting site collections to apply changes to" width="367" height="400" data-path="images/product/adoption-and-governance/adoption-hub/adoption-hub-3.png" />

When you click the <img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/adoption-hub/adoption-hub-4.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=ef753949c472ac591bf146c626544f28" alt="Publish theme button" style={{display:"inline-block",height:"1.5em",verticalAlign:"middle",margin:"0 0.15em"}} width="128" height="35" data-path="images/product/adoption-and-governance/adoption-hub/adoption-hub-4.png" /> button, any items selected will be applied to all FlowForma sites contained in those site collections.

### Selecting colors

When the page is opened, the Step color, Step background color, Step font color, Form background color and Separator color are displayed with 'Not selected' shown.

When 'Publish theme' is clicked to apply changes, the original colors are retained wherever 'Not selected' is displayed.

For any of the color items, click in the select field and a color picker is displayed.

<img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/adoption-hub/adoption-hub-5.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=f286bf67cc10ce39d4d41acc1d151147" alt="The color picker for a theme color" width="460" height="506" data-path="images/product/adoption-and-governance/adoption-hub/adoption-hub-5.png" />

Select the color you require and click outside of the picker, and the color will be added. Repeat this for any item you want to change. Click the reset icon next to a color item to clear your selection back to 'Not selected'.

Example:

<img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/adoption-hub/adoption-hub-6.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=b7702d2e3b56d9b03758c1ac40626dfa" alt="Example of selected theme colors" width="674" height="340" data-path="images/product/adoption-and-governance/adoption-hub/adoption-hub-6.png" />

When you click the <img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/adoption-hub/adoption-hub-7.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=8a88db2939a85c88134ccec2c107c680" alt="Publish theme button" style={{display:"inline-block",height:"1.5em",verticalAlign:"middle",margin:"0 0.15em"}} width="99" height="23" data-path="images/product/adoption-and-governance/adoption-hub/adoption-hub-7.png" /> button, the following pop-up is displayed.

<img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/adoption-hub/adoption-hub-8.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=81f229d231f428cec1c5a293b33e3a07" alt="Confirmation pop-up shown before applying theme changes" width="510" height="117" data-path="images/product/adoption-and-governance/adoption-hub/adoption-hub-8.png" />

Click the <img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/adoption-hub/adoption-hub-9.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=cd6810412f9b3b941f32fb5e209e6b1c" alt="Apply button" style={{display:"inline-block",height:"1.5em",verticalAlign:"middle",margin:"0 0.15em"}} width="94" height="30" data-path="images/product/adoption-and-governance/adoption-hub/adoption-hub-9.png" /> button to apply the changes to the sites in the selected site collection.

After you have clicked the button, the following processing screen is displayed.

<img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/adoption-hub/adoption-hub-10.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=dd9a700e8ea1bf11251890e26afd6fb7" alt="Processing screen shown while changes are applied" width="528" height="451" data-path="images/product/adoption-and-governance/adoption-hub/adoption-hub-10.png" />

When processing has completed, this is displayed in the panel.

<img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/adoption-hub/adoption-hub-11.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=f338c4a3194b2fdf56cd63f3fa838d22" alt="Completion message shown in the panel" width="551" height="513" data-path="images/product/adoption-and-governance/adoption-hub/adoption-hub-11.png" />

Example of a form created after the new theme elements have been applied:

<img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/adoption-hub/adoption-hub-12.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=d10dc8b9f473b8514e774c184f5dc401" alt="Example of a form after the new theme elements have been applied" width="1059" height="880" data-path="images/product/adoption-and-governance/adoption-hub/adoption-hub-12.png" />

Click the <img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/adoption-hub/adoption-hub-13.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=ec855a42e70aa278f7cc7d8ea41caa0f" alt="Cancel button" style={{display:"inline-block",height:"1.5em",verticalAlign:"middle",margin:"0 0.15em"}} width="70" height="28" data-path="images/product/adoption-and-governance/adoption-hub/adoption-hub-13.png" /> button to cancel the changes: no processing will take place and no changes will be made to any sites.

## User groups management

User groups management allows you to add, remove or replace a user from groups in all sites contained in the selected site collection(s).

Click the **User groups management** tile on the Adoption Hub screen and the following screen is displayed.

<img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/adoption-hub/adoption-hub-14.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=78724693a441d2afa3dee3b6c8f3b12d" alt="User group management screen" width="674" height="504" data-path="images/product/adoption-and-governance/adoption-hub/adoption-hub-14.png" />

The first section contains three radio buttons to select the action you wish to perform:

1. **Add user**: a selection field to choose the user to be added is displayed at the bottom of the screen.
2. **Remove user**: a selection field to choose the user to be removed is displayed at the bottom of the screen.
3. **Replace user**: two selection fields are displayed: the first to select the user to be replaced, the second to select the new user to be added.

<img src="https://mintcdn.com/flowforma/e4wTC4Z8qF9XOc7u/images/product/adoption-and-governance/adoption-hub/adoption-hub-15.png?fit=max&auto=format&n=e4wTC4Z8qF9XOc7u&q=85&s=7208242ae8054b14c2d60472661cb0c2" alt="Selecting the action and user for user group management" width="451" height="264" data-path="images/product/adoption-and-governance/adoption-hub/adoption-hub-15.png" />

The next section contains three checkboxes to select the user groups to be amended. You can select all the groups if required, or just a single group.

FlowForma sites have three standard user group settings:

1. Administrator group
2. Generic users group
3. Print view group

When you click the Add, Remove or Replace user button, a process is executed that checks each site in the selected site collection(s), identifies the Administrators, Generic users or Print view group associated with that site, and then adds, removes or replaces the selected user in each of the required groups.

The final section contains user selection field(s) to select the user to be added, removed or replaced.

### Site collections

The changes you make will be applied to the site collection(s) you select from the list of site collections on the right of the screen.

To select a site collection, check the checkbox next to the site collection you require. You must select at least one site collection, but you can select multiple if you wish.

## Customizations

Customizations allow you to deploy add-on questions and rules to all FlowForma apps in your tenancy, so the same custom questions and business rules can be reused across environments.

Click the **Customizations** tile and the available add-ons are listed, grouped into **Questions** and **Rules**.

Select the add-ons you want to deploy, you can select multiple from either group, and then click the **Install selected** button. A confirmation is displayed asking whether you want to install the selected customizations to all FlowForma apps; once confirmed, the selected questions and rules are installed across your apps.

## Master app

The Master app is the site collection and site that FlowForma uses as the source for shared customizations and settings.

Click the **Master app** tile and two drop-downs are displayed:

* **Site collection**: select the site collection that contains the app you want to use as the master.
* **Site**: select the site within that site collection.

Click **Save** to store the selected site as the master app. Click **Clear** to remove the current master app selection.
