**As** a user
**I want to** turn a project list public (accessible to everybody) or share it with a specific Begin of the insertionuser orEnd of the insertion group
**so that** I can have others reuse a list to form a shared view on projects

**Acceptance criteria**

* Begin of the insertionSharing:End of the insertion Begin of the deletion Sharing/Public:End of the deletion

* Begin of the insertionWithEnd of the insertion Begin of the deletion A user withEnd of the deletion the Begin of the insertionnecessary permissions the user can:

* CreateEnd of the insertion Begin of the deletion global permission "Share project lists" can shareEnd of the deletion a Begin of the insertionprivateEnd of the insertion Begin of the deletion projectEnd of the deletion list Begin of the insertionand share itEnd of the insertion with Begin of the insertiona limited amount ofEnd of the insertion Begin of the deletion otherEnd of the deletion users and groups. Begin of the deletion

* Users can access the project lists that are shared with them.

* For public lists, everyone can access them (does not even require to be logged in)End of the deletion

* Begin of the insertionCreate a private list and share itEnd of the insertion Begin of the deletion For shared lists, only usersEnd of the deletion with Begin of the insertioneveryone (all members ofEnd of the insertion Begin of the deletion whomEnd of the deletion the Begin of the insertioninstance).End of the insertion Begin of the deletion list are shared can access them.End of the deletion

* Begin of the insertionTheEnd of the insertion Begin of the deletion Sharing a list with users/groups or turning them public requiresEnd of the deletion additional permissions Begin of the insertionrequired to share a list are:End of the insertion

* Begin of the insertionShareEnd of the insertion Begin of the deletion Create publicEnd of the deletion project lists Begin of the insertionwith everyone (all instance)End of the insertion -> Permission to Begin of the insertionshare lists with everyone.End of the insertion Begin of the deletion turn a list public.End of the deletion

* Share Begin of the insertionprivateEnd of the insertion project lists -> Permission to share lists with other users. Begin of the insertion

End of the insertion Begin of the deletion

End of the deletion * Begin of the deletion **\[open\] Upon seeding a new instance, what roles are to receive the new permissions?**

* **\[open\] For existing installations, are there any roles that should automatically receive the new permissions?**

* End of the deletion A new global role is added to create public project lists. Begin of the insertion




End of the insertion Begin of the deletion

End of the deletion * Begin of the insertionUsers accessing shared lists:

* Users can accessEnd of the insertion Begin of the deletion **\[open\] What permission set willEnd of the deletion the Begin of the insertionproject listsEnd of the insertion Begin of the deletion role receive? What name doesEnd of the deletion that Begin of the insertionare shared with them.

End of the insertion Begin of the deletion role have?**

End of the deletion * Begin of the insertionFor lists shard with everyone: all instance members can access this lists (with their correspondent permissionsEnd of the insertion Begin of the deletion There is form that allowsEnd of the deletion to Begin of the insertionview or edit project lists)

* For private shared lists: onlyEnd of the insertion Begin of the deletion selectEnd of the deletion users Begin of the insertionorEnd of the insertion Begin of the deletion andEnd of the deletion groups Begin of the insertionwith whomEnd of the insertion the Begin of the deletion projectEnd of the deletion list Begin of the insertionareEnd of the insertion Begin of the deletion isEnd of the deletion shared Begin of the insertioncan access them.




End of the insertion Begin of the deletion with (similar to sharing work packages).

End of the deletion * Begin of the deletion The same form also allows to turn a list public if the user has the necessary permission.

* End of the deletion List deletion:

* Begin of the insertionLists shared with everyoneEnd of the insertion Begin of the deletion Public listsEnd of the deletion can be deleted by everyone having the edit permission.

* Shared Begin of the insertionprivateEnd of the insertion lists Begin of the insertioncan only be deleted by the owner of the list.

* Shared private listsEnd of the insertion cannot be deleted by users the list is shared with but, if a user wants to remove themself from a list that has been shared with them he can open the share modal and use the action "Remove" next to their name. Begin of the insertion




End of the insertion Begin of the deletion

End of the deletion * Begin of the insertionMaking changesEnd of the insertion Begin of the deletion The optionEnd of the deletion to Begin of the insertionlists:End of the insertion Begin of the deletion delete a list is only displayed in the "more" menu if the user has the permissions necessary to remove the list.

* Changing a public list:End of the deletion

* Begin of the insertionShared with everyoneEnd of the insertion Begin of the deletion PublicEnd of the deletion lists can be changed (renamed, column selection, filter selection, sort order selection) just like own lists Begin of the insertionbyEnd of the insertion Begin of the deletion forEnd of the deletion users having the edit permission.

* If the user lacks the edit permission, they have the same options as when changing a shared or static list. Begin of the insertionThey can always save as and create a private copy.End of the insertion

* Begin of the insertionChanging a private sharedEnd of the insertion Begin of the deletion A message and button appears similar to ownEnd of the deletion lists Begin of the insertioncan be doneEnd of the insertion Begin of the deletion (see #52152)

* When saving the new list (ownedEnd of the deletion by the Begin of the insertionowner and allEnd of the insertion Begin of the deletion current user then),End of the deletion the Begin of the deletion sharing configured from the template list is not copied over.

* Changing aEnd of the deletion shared Begin of the insertionusers with permissionsEnd of the insertion Begin of the deletion list:

* A message and button appears similarEnd of the deletion to Begin of the insertionedit.End of the insertion Begin of the deletion own lists (see #52152)End of the deletion

* Begin of the insertionIfEnd of the insertion Begin of the deletion When savingEnd of the deletion the Begin of the deletion new list (owned by the currentEnd of the deletion user Begin of the insertionlacksEnd of the insertion Begin of the deletion then),End of the deletion the Begin of the insertionedit permission, they haveEnd of the insertion Begin of the deletion sharing configured fromEnd of the deletion the Begin of the insertionsame options as when changing a shared or static list. They can always save as and create a private copy.




End of the insertion Begin of the deletion template list is not copied over.

End of the deletion * User deletion:

* In case the deleted user is the "owner" of lists that has been shared with other users the ownership will be transferred to the first user with sharing permissions in the shared list. If there is no such user left, the list would be removed.

* In case the deleted user is the "owner" of a Begin of the insertionshared with allEnd of the insertion Begin of the deletion publicEnd of the deletion list, the ownership of that list will be transferred to an instance administrator. Begin of the insertion




End of the insertion Begin of the deletion

End of the deletion * Sidebar:

* A section is added to the sidebar Begin of the insertionto listEnd of the insertion Begin of the deletion listingEnd of the deletion all Begin of the insertiontheEnd of the insertion Begin of the deletion project listsEnd of the deletion shared Begin of the insertionproject lists.End of the insertion Begin of the deletion with me (public or shared)End of the deletion


**Info**: The sharing of project lists only apply to the Begin of the deletion projectEnd of the deletion lists. It does not give the users access to the projects itself. So different users can see different results when clicking on shared project lists based on their individual project roles.

**Technical notes**

* Add an extra table for list visibility (join table between user and query)

* the user to that table (have a column indicating that the initial user is the owner)

* Needs having a type/role column on the table

* Add joined with users/groups to that table (use the type/role column to indicate that it is shared)


Begin of the insertion**Open questions**

* **\[open\]** Do we need two different permissions between sharing with users or groups and sharing with everyone?

* **\[open\]** Upon seeding a new instance, what roles are to receive the new permissions? 

* **\[open\]** For existing installations, are there any roles that should automatically receive the new permissions? _I would argue that project managers and admins should have this permisisons activated by default._

* **\[open\]** What permission set and name will the new global role for sharing project lists will receive?


End of the insertion **Relevant translations**

<figure class="table op-uc-figure_align-center op-uc-figure"><table class="op-uc-table"><thead class="op-uc-table--head"><tr class="op-uc-table--row"><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">EN (<a class="op-uc-link" href="https://www.figma.com/file/YCCMdJWkrtP9YSmf49Od0i/Project-lists?type=design&amp;node-id=1830-41294&amp;mode=design&amp;t=JWw5I0eRsONBc6xj-4">Figma link</a>)</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">DE (Figma link)</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">ES (<a class="op-uc-link" href="https://www.figma.com/file/YCCMdJWkrtP9YSmf49Od0i/Project-lists?type=design&amp;node-id=1912-23079&amp;mode=design&amp;t=JWw5I0eRsONBc6xj-4">Figma link</a>)</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">FR (<a class="op-uc-link" href="https://www.figma.com/file/YCCMdJWkrtP9YSmf49Od0i/Project-lists?type=design&amp;node-id=1916-15593&amp;mode=design&amp;t=JWw5I0eRsONBc6xj-4">Figma link</a>)</p></th></tr></thead><tbody><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">Share project list</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td><td class="op-uc-table--cell"><p class="op-uc-p">Compartir lista de proyectos</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Partager la liste des projets</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">Please note that the projects in the list might differ from one user to another depending on which projects the user has access to.</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td><td class="op-uc-table--cell"><p class="op-uc-p">Por favor, tenga en cuenta que la lista de proyectos puede variar para otros usuarios dependiendo a qué proyectos tienen acceso.</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Veuillez noter que les projets figurant dans la liste peuvent différer d'une personne à l’autre en fonction des projets auxquels l'utilisateur a accès.</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">Project list visibility in this instance:</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td><td class="op-uc-table--cell"><p class="op-uc-p">Visibilidad de la lista de proyectos en la instancia:</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Visibilité de la liste des projets dans cette instance:</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">Private</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td><td class="op-uc-table--cell"><p class="op-uc-p">Privada</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Privé</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">Only you and users with whom this project list is shared can see or edit it.</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td><td class="op-uc-table--cell"><p class="op-uc-p">Solo usted y los usuarios con quien se ha compartido esta lista de proyectos podrán verla o editarla.</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Seuls vous et les utilisateurs avec lesquels cette liste de projets est partagée pouvez la voir ou la modifier.</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">Shared with everyone</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td><td class="op-uc-table--cell"><p class="op-uc-p">Compartida con todos</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Partagée avec tout le monde</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">All instance members can view this project list. Those with edit permissions can modify it.</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td><td class="op-uc-table--cell"><p class="op-uc-p">Todos los miembros de la instancia pueden ver esta lista de proyectos. Aquellos que tengan derechos de edición podrán modificarla.</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Tous les membres de l'instance peuvent consulter cette liste de projets. Ceux qui ont des droits de modification peuvent la modifier.</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">Search by user or group</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td><td class="op-uc-table--cell"><p class="op-uc-p">Buscar por usuario o grupo</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Recherche par utilisateur ou par groupe</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">Not shared with anyone</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td><td class="op-uc-table--cell"><p class="op-uc-p">No compartida</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">This project list has not been shared with anyone yet.</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td><td class="op-uc-table--cell"><p class="op-uc-p">Esta lista de proyecto no se ha compartido aún con nadie.</p></td><td class="op-uc-table--cell"><p class="op-uc-p"></p></td></tr></tbody></table></figure>

**Figma and visuals**

https://www.figma.com/file/YCCMdJWkrtP9YSmf49Od0i/Project-lists?type=design&amp;node-id=1830-41294&amp;mode=design&amp;t=JWw5I0eRsONBc6xj-4