How to rename, commit, promote and deploy standard field labels

In order to change the label of a standard field in Salesforce, you need to use the Rename Tabs and Labels feature. From Setup, enter Rename Tabs and Labels in the Quick Find box, then select Rename Tabs and Labels.

Rename the standard field for example, the Case field called "Description" can be renamed to "Case Description".

User-added image

Now you can move the new label to a different org with Copado following the steps below:

1. From a user story, click on Commit Files and commit the Case field you have renamed and the Custom Object Translation for the case object and language English which was the language selected when changing the label.

User-added image

Please note that not all the standard fields are deployable with the Salesforce Metadata API therefore we recommend to use the Retrieve Only option with standard fields. This will prevent the deployment to fail if the field selected is not deployable.

2. Commit the components selected and check that the new label has been committed in Git.

User-added image

3. Promote and Deploy the user story.

If your deployment fails with an error similar to the one below:

[ Case.CaseNumber] An object 'Case.CaseNumber' of type CustomField was named in package.xml, but was not found in zipped directory.

That means that the standard field that you selected in the commit is not deployable with the Metadata API and it has to be selected as Retrieve Only.

4. Once the deployment is completed, the field will appear as renamed in the Rename Tabs and Labels Setup page in the target org.

How did we do?