# Creating and managing workgroups

{% hint style="info" %}
Workgroups can only be created and managed by a Stewardship Organisation or registry Administrator.
{% endhint %}

A workgroup is an administrative collection of people working together to create a set of metadata for a specific purpose. A workgroup exists within and beneath a Stewardship Organisation, and its members can be comprised only of users that are already members of its parent Stewardship Organisation.

Stewardship Organisation Administrators can create a workgroup for their Stewardship Organisation, and subsequently manage its members and settings.

## How to create a workgroup <a href="#creating_a_new_workgroup" id="creating_a_new_workgroup"></a>

**Note:** Workgroups can be archived after creation, but not deleted.

1. Navigate to the desired Stewardship Organisation, then select the 'Workgroups' tab.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FEQjASaEzLPbmXN2KYyVE%2Fimage.png?alt=media&#x26;token=e6900448-eef3-4d9b-9780-0ed80725f91c" alt=""><figcaption></figcaption></figure>

2. Select 'Add New Workgroup'.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2F52SEDAq9QG7YRK4dQzE9%2Fimage.png?alt=media&#x26;token=d2568b80-4be7-49a7-b796-a3871a624f46" alt=""><figcaption></figcaption></figure>

**Note: If you wish to edit the basic details of an existing workgroup**, select 'Edit' from the 'Workgroups' tab (below).

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FPkvrTjshwMEjMJMt5bvg%2Fimage.png?alt=media&#x26;token=bf208f2e-6c84-4867-8ad5-3e0f9ab5b750" alt=""><figcaption></figcaption></figure>



3. Populate the 'Name' and 'Definition' fields as desired:

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FraKlN8NOeIgJI1bnQgvc%2Fimage.png?alt=media&#x26;token=8cf48fdc-2049-4f0c-ae48-5e0cd9aa464b" alt=""><figcaption></figcaption></figure>

4. Select what users will be able to see this workgroup via the 'Workgroup Visibility' field.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2Fuol4nATkYLNUZPwsQBKh%2Fimage.png?alt=media&#x26;token=d931d56d-7f8d-4984-ae5c-21c95d69c30a" alt=""><figcaption></figcaption></figure>

5. Select whether this workgroup's metadata will be visible to non-workgroup members via the 'Metadata Vsibility' field.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FRLuSn8Burc2ViWOQj6EV%2Fimage.png?alt=media&#x26;token=baa14a26-0a10-4122-b25f-2f4850b691cd" alt=""><figcaption></figcaption></figure>

6. Select whether this workgroup will be displayed in the infoboxes of metadata items that belong to it via the 'Display Options' field.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FQcdOeZpDi4HLFHyqYBGr%2Fimage.png?alt=media&#x26;token=4b532cab-4944-4689-b275-30a3a3f29429" alt=""><figcaption></figcaption></figure>

**Note: If the 'Allow workgroup managers to select to show this Workgroup on each item page' option is selected**, workgroup Managers can choose whether or not to display workgroup association on a per-item basis by navigating to the relevant item page and selecting 'Show workgroup association' from its 'Actions' dropdown (below).

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FsdxE31pI78KyAMgJHYDu%2Fimage.png?alt=media&#x26;token=05c3f96a-19ac-457c-a86e-62726cc172e7" alt=""><figcaption></figcaption></figure>

7. **If you wish to display this workgroup's contact information on its homepage**, select 'Display contact email on workgroup homepage' and populate the 'Contact email' field with the relevant email address.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FmWv6yW01RGJVS1kWkyYs%2Fimage.png?alt=media&#x26;token=384f8afb-fd3e-42ef-aeef-df3498d412de" alt=""><figcaption></figcaption></figure>

8. Select 'Create new Workgroup' once satisfied.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2Fmvy2rMSwLVuD4nyFvZRq%2Fimage.png?alt=media&#x26;token=a14720ce-629d-4c86-bb6e-8f91a14799e1" alt=""><figcaption></figcaption></figure>

## How to manage a workgroup <a href="#managing_a_workgroup" id="managing_a_workgroup"></a>

1. Select the 'Workgroups' tab of the relevant Stewardship Organisation.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FVTJFRJ8sggrdHsOZbRc7%2Fimage.png?alt=media&#x26;token=bbaa9646-61f1-4d90-8c33-7023a0fd885d" alt=""><figcaption></figcaption></figure>

2\. Select the workgroup you wish to manage.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FV5QicE98nCPSIxsKEMq2%2Fimage.png?alt=media&#x26;token=8efd031b-1901-4036-8134-360caee51907" alt=""><figcaption></figcaption></figure>

3\. **If you wish to manage workgroup discussions**, select the 'Discussions' tab. From here, you can create, edit and contribute to discussions relevant to this workgroup and its metadata.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FjCSFbbkTBjLiM72TA5Hq%2Fimage.png?alt=media&#x26;token=69b3062c-b33f-4735-a035-b3a23db4c575" alt=""><figcaption></figcaption></figure>

4. **If you wish to manage workgroup issues**, Select the 'Issues' tab. From here you can create, edit and contribute to issues relevant to this workgroup and its metadata.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FpLZHpSXpkW7sr5ygvYRd%2Fimage%20(10).png?alt=media&#x26;token=54e10f60-c9f5-45af-8389-d98f2c95c07f" alt=""><figcaption></figcaption></figure>

5. **If you wish to manage workgroup reviews,** Select the 'Reviews' tab. From here you can create, edit and contribute to issues relevant to this workgroup and its metadata.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FIrsatrIlhERvbFrp99bk%2Fimage.png?alt=media&#x26;token=99b4a9ee-810a-4bd2-85a3-5d4e75ae6ce2" alt=""><figcaption></figcaption></figure>

6. **If you wish to add, change the role of or remove workgroup members,** select the 'Members' tab. **If you do not wish to add, change the role of or remove workgroup members**, proceed to step 16.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FiGTRfD5F1vkRb0pVCZyG%2Fimage.png?alt=media&#x26;token=2b06b4f7-b4c4-4f2c-99a8-cb8c0e7e3731" alt=""><figcaption></figcaption></figure>

7. **If you wish to add a user to this workgroup**, select 'Add a user'. **If you do not wish to add a user to this workgroup**, proceed to step 11.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2F0h7FBKPLOjkmKVFGxu5d%2Fimage.png?alt=media&#x26;token=b97a1d0d-e71d-4c6b-ace2-6fa2d5290587" alt=""><figcaption></figcaption></figure>

8. Select the user(s) you wish to add to the workgroup from the 'User' field.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2F1Ois3I3ijbVf2Qf4C8wZ%2Fimage.png?alt=media&#x26;token=6e97d85c-9db4-4353-847e-fc657806306e" alt=""><figcaption></figcaption></figure>

9. Select the role you wish to grant the chosen user(s) from the 'Role' field.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FzxqSVnJPiePzqs9wAcrt%2Fimage.png?alt=media&#x26;token=d5f913d6-100d-4354-ba45-676958391f76" alt=""><figcaption></figcaption></figure>

10. Select 'Add member'.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FFmeyqPkbewBtOJbQmlIA%2Fimage.png?alt=media&#x26;token=9938b4d2-ab54-423f-a657-7ecd6b8bbf2e" alt=""><figcaption></figcaption></figure>

11. **If you wish to change the role of a workgroup member**, select the settings icon from their row in the 'Members' tab, then select 'Change roles'. **If you do not wish to change the role of a workgroup member**, proceed to step 14.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FhKuosUJmTTmdG1iTrefp%2Fimage.png?alt=media&#x26;token=9d14120c-27b6-4755-a090-c2ee94a02156" alt=""><figcaption></figcaption></figure>

12. Select the role you wish to assign to this user from the 'Roles' field.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2F6nJ2iAquBawNYadbltcY%2Fimage.png?alt=media&#x26;token=b91562da-f482-45c5-8b0f-b8abba58ee87" alt=""><figcaption></figcaption></figure>

13. Select 'Change roles'.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FS0GoGCJfHCqyq0K8fTeC%2Fimage.png?alt=media&#x26;token=df525c3f-a0ca-497d-a538-2a82c00c3a32" alt=""><figcaption></figcaption></figure>

14. **If you wish to remove a user from the workgroup**, select the settings icon from their row in the 'Members' tab, then select 'Remove from this group.' **If you do not wish to remove a user from the workgroup**, proceed to step 16.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FLpENSmduU3LDGsCcaecT%2Fimage.png?alt=media&#x26;token=940e75e3-5419-4556-8377-819d36ea5832" alt=""><figcaption></figcaption></figure>

15. Select 'Remove user'.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FgCjSJGsGeESNrrfpGesf%2Fimage.png?alt=media&#x26;token=3b2aee24-08ef-496b-b9e6-b06ac322dd5f" alt=""><figcaption></figcaption></figure>

16. **If you wish to adjust workgroup settings**, select the 'Settings' tab.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2Fh1lSLL7fDO7vBep3NgpV%2Fimage.png?alt=media&#x26;token=012c2c02-6f01-4b80-be20-af847010ecf0" alt=""><figcaption></figcaption></figure>

17. **If you wish to adjust general workgroup settings**, adjust the 'Name' and 'Definition' fields as desired. **If you do not wish to adjust general workgroup settings**, proceed to step 20.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FpJeXAKrar0uyLCjjwXpQ%2Fimage.png?alt=media&#x26;token=ebc24517-003d-482b-89c2-86aded343f48" alt=""><figcaption></figcaption></figure>

18. Adjust what users can propose and apply changes using issues via the 'Who can propose changes' and 'Who can apply issue changes' fields respectively.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2F0JpdrcrmOS767vrf2aPr%2Fimage.png?alt=media&#x26;token=75d9b1ae-256b-4418-a940-f7acb8ccc141" alt=""><figcaption></figcaption></figure>

19. Select 'Save changes' once satisfied.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FthghH1mXZHOjLibnwtpj%2Fimage.png?alt=media&#x26;token=786965cf-bda4-4dba-90c5-13f6d57e073d" alt=""><figcaption></figcaption></figure>

20. **If you wish to adjust visibility settings**, select the 'Visibility' tab. **If you do not wish to adjust visibility settings**, proceed to step 26.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FECfI8DDFxrnxoe4TrKxM%2Fimage.png?alt=media&#x26;token=f09f8d44-cee0-4a1c-b969-c7d258efac28" alt=""><figcaption></figcaption></figure>

21. Select what users will be able to see this workgroup via the 'Workgroup Visibility' field.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2Fuol4nATkYLNUZPwsQBKh%2Fimage.png?alt=media&#x26;token=d931d56d-7f8d-4984-ae5c-21c95d69c30a" alt=""><figcaption></figcaption></figure>

22. Select whether this workgroup's metadata will be visible to non-workgroup members via the 'Metadata Vsibility' field.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FRLuSn8Burc2ViWOQj6EV%2Fimage.png?alt=media&#x26;token=baa14a26-0a10-4122-b25f-2f4850b691cd" alt=""><figcaption></figcaption></figure>

23. Select whether this workgroup will be displayed in the infoboxes of metadata items that belong to it via the 'Display Options' field.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FQcdOeZpDi4HLFHyqYBGr%2Fimage.png?alt=media&#x26;token=4b532cab-4944-4689-b275-30a3a3f29429" alt=""><figcaption></figcaption></figure>

24. **If you wish to display this workgroup's contact information on its homepage**, select 'Display contact email on workgroup homepage' and populate the 'Contact email' field with the relevant email address.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FmWv6yW01RGJVS1kWkyYs%2Fimage.png?alt=media&#x26;token=384f8afb-fd3e-42ef-aeef-df3498d412de" alt=""><figcaption></figcaption></figure>

25. Select 'Save changes' once satisfied.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2Fz0U55o5PHLayD3fxhmKf%2Fimage.png?alt=media&#x26;token=707ff2f8-cf1b-4599-9460-88584e1c38f6" alt=""><figcaption></figcaption></figure>

26. **If you wish to move the workgroup to a different Stewardship Organisation**, select the 'Move Workgroup' tab.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FxhQWsvz8RK0KvtcOjaVH%2Fimage.png?alt=media&#x26;token=96cc8ead-afe7-4b7f-846a-b8cf4e9e357d" alt=""><figcaption></figcaption></figure>

27. Select the Stewardship Organisation you wish to migrate the workgroup to via the 'New Stewardship Organisation' dropdown.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FNniN9ryjK47Yig9fQ6e3%2Fimage.png?alt=media&#x26;token=d25b69f5-0393-4aa7-933f-d495792c4de8" alt=""><figcaption></figcaption></figure>

28. Select whether the workgroup's members will be granted membership in the chosen Stewardship Organisation by toggling the 'Migrate memberships' checkbox.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FxUp4CElDCIIrN9cPBU10%2Fimage.png?alt=media&#x26;token=b71f09b7-868e-4d43-8655-51426fc5e4c3" alt=""><figcaption></figcaption></figure>

**Note:** If this checkbox is left unticked, all workgroup members will be removed from the workgroup.

29. Select 'Move'.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2Fm5xLGNEN71evI4kvIevD%2Fimage.png?alt=media&#x26;token=174df294-8c6b-4afa-bed6-a89e4210bc45" alt=""><figcaption></figcaption></figure>
