{"id":5864,"date":"2023-11-02T08:00:53","date_gmt":"2023-11-02T08:00:53","guid":{"rendered":"https:\/\/www.process.st\/help\/docs\/role-assignments\/"},"modified":"2026-05-13T06:19:41","modified_gmt":"2026-05-13T06:19:41","slug":"role-assignments","status":"publish","type":"ht_kb","link":"https:\/\/www.process.st\/help\/docs\/role-assignments\/","title":{"rendered":"Role Assignments"},"content":{"rendered":"<p>With role assignments, you can dynamically assign tasks to users in different roles on your team.<\/p>\n<p>This is useful for larger teams where different people might complete a task depending on their role, or if you want to assign different team members to tasks in different Workflow runs, or if you want to dynamically invite external users to complete a specific task or tasks.<\/p>\n<p><iframe loading=\"lazy\" src=\"https:\/\/www.youtube.com\/embed\/UECbJjKvGAk\" width=\"100%\" height=\"406\" frameborder=\"0\" allowfullscreen=\"allowfullscreen\"><span data-mce-type=\"bookmark\" style=\"display: inline-block; width: 0px; overflow: hidden; line-height: 0;\" class=\"mce_SELRES_start\">\ufeff<\/span><span data-mce-type=\"bookmark\" style=\"display: inline-block; width: 0px; overflow: hidden; line-height: 0;\" class=\"mce_SELRES_start\"><span data-mce-type=\"bookmark\" style=\"display: inline-block; width: 0px; overflow: hidden; line-height: 0;\" class=\"mce_SELRES_start\">\ufeff<\/span>\ufeff<\/span><span data-mce-type=\"bookmark\" style=\"display: inline-block; width: 0px; overflow: hidden; line-height: 0;\" class=\"mce_SELRES_start\">\ufeff<\/span><\/iframe><\/p>\n<p><em><strong><i>Users: In order to add Role Assignments to Workflows, you must be an Administrator or a <a href=\"https:\/\/www.process.st\/help\/docs\/what-is-a-full-member\/\">Builder<\/a> who has been given <\/i><i>\u2018edit\u2019<\/i><i> access by your Administrator.<\/i><\/strong><\/em><\/p>\n<h2 id=\"common-use-cases-for-approvals\">Example use cases<\/h2>\n<ul>\n<li>Your <a href=\"https:\/\/www.process.st\/new-hire-checklist\/\">employee onboarding<\/a> process will be completed by one of your HR team, but this may vary each time depending on their availability. Using the <em>members form field<\/em>, you can dynamically assign one of the team to the relevant tasks, once you run the Workflow<\/li>\n<li>You have a series of <a href=\"https:\/\/www.process.st\/templates\/podcast-publishing-checklist\/\">podcasts<\/a> planned and you have a different client co-hosting with you on each one. Using the <em>email form field<\/em> you can dynamically assign selected tasks to whichever email address you fill out in your Workflow runs. Filling out their email address effectively invites your client into your Workflow run as a guest, where they can complete their tasks<\/li>\n<li>You are listing a <a href=\"https:\/\/www.process.st\/help\/docs\/real-estate\/\">new property for sale<\/a> and you need to involve a number of colleagues in the process at different points. Since you are the one running the Workflow for the team, the first few tasks are dynamically assigned to you as the <em>Workflow\u00a0runner<\/em>, before you can then hand off the process to the rest of your team<\/li>\n<\/ul>\n<h2>How to use role assignments<\/h2>\n<p>There are 3 ways in which you can assign a role to a task:<\/p>\n<ul>\n<li>Using the <a href=\"https:\/\/www.process.st\/help\/docs\/global-variables\/\">Workflow runner variable<\/a><\/li>\n<li>Using the <a href=\"https:\/\/www.process.st\/help\/docs\/form-fields\/\">members form field<\/a><\/li>\n<li>Using the <a href=\"https:\/\/www.process.st\/help\/docs\/form-fields\/\">email form field<\/a><\/li>\n<\/ul>\n<h3>Workflow runner<\/h3>\n<p>You can use the <strong>Workflow runner<\/strong>\u00a0variable to automatically assign tasks to the user who <a href=\"https:\/\/www.process.st\/help\/docs\/running-workflows\/\">manually runs<\/a> the Workflow. This means that the person assigned to the task\/s will be dynamically assigned based on who has <a href=\"https:\/\/www.process.st\/help\/docs\/running-checklists\/\">run the Workflow<\/a>.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-14184\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/assign-workflow-runner.png\" alt=\"\" width=\"100%\" \/><\/p>\n<p><strong>Note:<\/strong> The Workflow runner will not be assigned if you run your Workflow via <a href=\"https:\/\/www.process.st\/help\/docs\/automations\/\">automation<\/a> or <a href=\"https:\/\/www.process.st\/help\/kb\/integrations\/\">integration<\/a>.<\/p>\n<p>In the example below, the first two tasks and the last task, have been assigned to the Workflow runner. When someone manually runs the Workflow, those tasks were assigned to that person automatically.<\/p>\n<div style=\"width: 1544px;\" class=\"wp-video\"><video class=\"wp-video-shortcode\" id=\"video-5864-1\" width=\"1544\" height=\"720\" preload=\"metadata\" controls=\"controls\"><source type=\"video\/mp4\" src=\"https:\/\/s3-us-west-2.amazonaws.com\/bolin\/wp-content\/uploads\/2022\/09\/workflow-runner-role-assignment.mp4?_=1\" \/><a href=\"https:\/\/s3-us-west-2.amazonaws.com\/bolin\/wp-content\/uploads\/2022\/09\/workflow-runner-role-assignment.mp4\">https:\/\/s3-us-west-2.amazonaws.com\/bolin\/wp-content\/uploads\/2022\/09\/workflow-runner-role-assignment.mp4<\/a><\/video><\/div>\n<h3>Members Form Field<\/h3>\n<p>Using the members <a href=\"https:\/\/www.process.st\/help\/docs\/form-fields\/\">form field<\/a> allows you to select a user from either <a href=\"https:\/\/www.process.st\/help\/docs\/what-is-the-all-members-group\/\">a list of all members<\/a> in your organization, or from a specific <a href=\"https:\/\/www.process.st\/help\/docs\/what-are-groups\/\">group <\/a>of members, like a <a href=\"https:\/\/www.process.st\/help\/docs\/groups\/\">group<\/a> of Sales, Marketing, or Human Resources staff.<\/p>\n<p>When you run the Workflow, use that <strong>members form field<\/strong> to select a member from that specific <strong>group<\/strong> in the dropdown that appears. This will then dynamically assign that user to the required tasks.<\/p>\n<p>For example, when onboarding a new employee, you might assign an HR Manager for most of the tasks, and assign a Manager as the Approver, as shown in the example below:<\/p>\n<div style=\"width: 1538px;\" class=\"wp-video\"><video class=\"wp-video-shortcode\" id=\"video-5864-2\" width=\"1538\" height=\"720\" preload=\"metadata\" controls=\"controls\"><source type=\"video\/mp4\" src=\"https:\/\/s3-us-west-2.amazonaws.com\/bolin\/wp-content\/uploads\/2022\/09\/member-field-role-assignment.mp4?_=2\" \/><a href=\"https:\/\/s3-us-west-2.amazonaws.com\/bolin\/wp-content\/uploads\/2022\/09\/member-field-role-assignment.mp4\">https:\/\/s3-us-west-2.amazonaws.com\/bolin\/wp-content\/uploads\/2022\/09\/member-field-role-assignment.mp4<\/a><\/video><\/div>\n<p><strong>Note:<\/strong> Admins, <a href=\"https:\/\/www.process.st\/help\/docs\/what-is-a-full-member\/\">Builders<\/a> and <a href=\"https:\/\/www.process.st\/help\/docs\/what-is-a-guest-internal\/\">Users<\/a> can be assigned in this way, <a href=\"https:\/\/www.process.st\/help\/docs\/guests\/\">Guests<\/a>\u00a0cannot.<\/p>\n<p>To set this up first add a <a href=\"https:\/\/www.process.st\/help\/docs\/form-fields\/\">members form field<\/a> to your Workflow in edit mode and give it a descriptive label, like &#8220;Account Manager&#8221;, &#8220;Approver&#8221; or &#8220;HR Manager&#8221;. The default group in this field is the &#8220;<a href=\"https:\/\/www.process.st\/help\/docs\/what-is-the-all-members-group\/\">All Organization group<\/a>&#8220;, but you want to choose the appropriate group for this specific process, from the dropdown list. Learn more about <a href=\"https:\/\/www.process.st\/help\/docs\/groups\/\">creating groups<\/a>.<\/p>\n<p>Next, select all the tasks you would like to assign this role to. Click <strong>&#8220;Assign&#8221;,<\/strong> and choose the <strong>members field\u00a0role<\/strong> you want to assign.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-14186\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/assign-member.png\" alt=\"\" width=\"100%\" \/><\/p>\n<p>When you run the Workflow, select a person from the list shown in the member&#8217;s field, and it will dynamically assign that user to your tasks.<\/p>\n<h3>Email Form Field<\/h3>\n<p>Using the email <a href=\"https:\/\/www.process.st\/help\/docs\/form-fields\/\">form field<\/a> allows you to dynamically assign an email address to tasks in a Workflow run. This is useful for inviting <a href=\"https:\/\/www.process.st\/help\/docs\/guests\/\">guests<\/a> (external collaborators) into your Workflow runs at the points you need them.<\/p>\n<p>In the example below, we&#8217;re using the client email address to assign the client to the approval task, once their email address has been entered into the Workflow run.<\/p>\n<div style=\"width: 1532px;\" class=\"wp-video\"><video class=\"wp-video-shortcode\" id=\"video-5864-3\" width=\"1532\" height=\"720\" preload=\"metadata\" controls=\"controls\"><source type=\"video\/mp4\" src=\"https:\/\/s3-us-west-2.amazonaws.com\/bolin\/wp-content\/uploads\/2022\/09\/email-field-role-assignment.mp4?_=3\" \/><a href=\"https:\/\/s3-us-west-2.amazonaws.com\/bolin\/wp-content\/uploads\/2022\/09\/email-field-role-assignment.mp4\">https:\/\/s3-us-west-2.amazonaws.com\/bolin\/wp-content\/uploads\/2022\/09\/email-field-role-assignment.mp4<\/a><\/video><\/div>\n<p><strong>Note:<\/strong> If you invite guests to your Workflow runs, be sure to consider using <a href=\"https:\/\/www.process.st\/help\/docs\/task-permissions\/\">task permissions<\/a>, to only show them the tasks you&#8217;d like them to work on and not the whole run.<\/p>\n<p>Start by adding an email form field into your Workflow. For employee onboarding, this might be the &#8220;Referee email address&#8221; or &#8220;Employee email address&#8221;. Next, assign the desired task to the <strong>email field role<\/strong> and publish changes to your Workflow.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-14187\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/email-assign.png\" alt=\"\" width=\"100%\" \/><\/p>\n<p>When you run the Workflow, enter an email address into the form field you added earlier. This will invite the person as a Guest in your organization, and give them access to the Workflow run to complete their assigned task\/s.<\/p>\n<p><strong>Pro tip:<\/strong>\u00a0Members fields and Email fields can be auto-populated with data from other apps by using an <a href=\"https:\/\/www.process.st\/help\/docs\/automations\/\">automation<\/a>,\u00a0 via <a href=\"https:\/\/www.process.st\/help\/docs\/zapier\/\">Zapier<\/a>, when using <a href=\"https:\/\/www.process.st\/help\/docs\/checklist-run-link\/\">Workflow run links<\/a> or when you <a href=\"https:\/\/www.process.st\/help\/docs\/creating-multiple-workflow-runs\/\">run multiple Workflows from a CSV file<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>With role assignments, you can dynamically assign tasks to users in different roles on your team. This is useful for larger teams where different people might complete a task depending on their role, or if you want to assign different team members to tasks in different Workflow runs, or if you want to dynamically invite [&hellip;]<\/p>\n","protected":false},"author":7,"template":"","meta":{"_acf_changed":false,"available_plan":"All plans","available_product":"Workflows","footnotes":""},"ht_kb_category":[168,158],"ht_kb_tag":[367,368],"class_list":["post-5864","ht_kb","type-ht_kb","status-publish","hentry","ht_kb_category-run-workflows","ht_kb_category-build-edit-workflows","ht_kb_tag-assign-roles","ht_kb_tag-role-assignments"],"acf":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb\/5864","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb"}],"about":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/users\/7"}],"version-history":[{"count":5,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb\/5864\/revisions"}],"predecessor-version":[{"id":9954,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb\/5864\/revisions\/9954"}],"wp:attachment":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/media?parent=5864"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb_category?post=5864"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb_tag?post=5864"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}