This documentation is in maintenance status and may not reflect the latest product updates. Please see the release notes for product updates.

Office 365 update item permissions

Nintex external platform is required for this feature. For details, see Enable Nintex external platform features.

Updates permissions for existing items in a list or document library on SharePoint Online.

Action settings

Following are the fields and options visible in the configuration settings dialog box for this action.

Section	Field	Description
(unlabeled)	Destination site URL	The URL of the destination site where the items to be updated are located.
	List name	The name of the list or document library where the items are located.
	Items to update	Specify a query to determine which items are to be updated, specify whether or not to update folders and items within subfolders, and add filters to the query. Query builder: Build a query to filter for items to update. View the CAML at any time by switching to the CAML Editor mode. CAML editor: Create a more advanced query using XML encoding. Scope: Specify options to determine the view scope of updates. Select or clear the following check boxes. Include items in subfolders: When selected, updates items within subfolders. Include folders: When selected, updates folders. Filters: Specify the criteria that items must match for the permission to be updated. Select one of the following options. Update all list item permissions: Updates all items in the list or document library. Update items only when the following is true: Updates an item permission based on the values set in the column. Update the items when column / When column: Specify a column, select an operator, and specify a value. Add filter rule: Add a filter. Delete (): Delete a filter. Displayed for second and subsequent filters. And / Or: Specify how to group sequential filters. Query Examples: Update only items in the root folder Clear check box for Include items in subfolders Clear check box for Include folders Update only items and folders in the root folder Select check box for Include folders Update only folders in the root folder Select check box for Include folders Specify filter to update items when column FSObjType is equal to 1 Update all items in the list Select check box for Include items in subfolders Update all items and folders in the list Clear check box for Include items in subfolders Clear check box for Include folders Update all folders in the list Select check box for Include items in subfolders Select check box for Include folders Specify filter to update items when column FSObjType is equal to 1
	Inherit permissions from parent	Specify if the item permission will link to the parent permission set (the permissions used in the library or list that contains the item). Inheriting permissions does not apply any other permission settings.
	Remove existing permissions	Specify whether or not to clear the permissions that are currently set on the item before adding the new permissions. If the item permission currently links to the parent permission set (the permissions used in the library or list that contains the item), unselecting this option will cause the inherited permissions to be copied to the items.
User permissions	Target	Specify the target. Select one of the following items. User Group
	User or group name	Specify one or more target-dependent values to assign access permissions for the specified items. Separate values with semicolons, commas, or new lines. For the Target selection of User, specify one or more email addresses. For the Target selection of Group, specify one or more SharePoint group names.
	Permission	Specify the level of permission that can be assigned to a user for the item. Unless Remove existing permissions is selected, the permission will be added to the user's existing rights. Select one of the following items. Full Control Design Edit Note: The Edit option is only available on Office 365 SharePoint 2013. Contribute Read View Only Remove
Credentials	SharePoint Online URL	Specify the SharePoint Online website domain URL. Example: http://targetdomain.sharepoint.com.
	Username	A username with permissions to update the items in the destination site.
	Password	The password for the above username.
(unlabeled)	Output	Store output for this action using the following selections. All matched items updated: Specify a Yes/No variable to store whether or not all matched items have been updated. Returns "Yes" if all matched items were successfully updated. List item ID: Specify a collection variable to store the ID of the updated items. List item URL: Specify a collection variable to store the URL of updated items. How to add and remove output variables Depending on action requirements, you may be able to add and remove output variables. To add an output variable Select an option from the Select more drop-down list. Click Add to display a drop-down list for the selected option. Select a previously defined workflow variable from the drop-down list. To remove an output variable Click Delete (). Note: Some output variables cannot be deleted. For example, the output variable URL for the action Bing news search cannot be deleted.