Loading

Salesforce Deployment Error - Unknown user permission: ChatterFileLink When Deploying Profile

Publish Date: Jun 3, 2026
Description

Sometimes the deployment fails with the permission "Unknown user permission: ChatterFileLink" while deploying profile or permission set. This means that the target organization does not have Public Links enabled.

This error occurs because the source organization has ChatterFileLink enabled, and the "Public Links can be enabled for users (Requires Content Deliveries)" permission is included in the source Profile.

The target organization does not have ChatterFileLink enabled, so it does not recognize the ‘Public Links can be enabled for users (Requires Content Deliveries)’ permission and rejects the deployment.

Resolution

When “ChatterFileLink” is disabled, the OrgPreferences.ChatterFileLink will also be disabled. Consequently, the user permission "ChatterFileLink" becomes unavailable. As a result, attempting to deploy this user permission, whether set to True or False, will result in an error. To resolve this, you would need to either enable “ChatterFileLink” in the destination org or remove the permission from the XML/metadata file.

Steps to enable the permission:-

1. Setup -> Content Deliveries and Public Links.
2. Enable the permission 'Content Deliveries feature can be enabled for users' as well as 'Public Links can be enabled for users (Requires Content Deliveries)'.

Removing this permission from the source Profile before retrieval and deployment prevents the unrecognized ChatterFileLink permission from being included in the Change Set and resolves the deployment failure.

Knowledge Article Number

005385945

 
Loading
Salesforce Help | Article