CopyFiles@1 is retired: replace it with CopyFiles@2
The short answer
- Retirement date
- Removal date
- . Pipelines that still use it fail after removal.
- Replacement
CopyFiles@2- Kind of migration
- drop-in replacement
- Automatic rewrite
- Not yet. Automatic rewrite is planned for this kind of task (drop-in replacement). Today, trasloco modernize --check finds the step and you change it by hand.
- Recommended action
- Replace CopyFiles@1 with CopyFiles@2.
Official sources
- Official task retirement announcement
- Task definition: CopyFiles (task.json)
- Task definition: CopyFilesV2 (task.json)
Last verified:
Why does my pipeline show a retirement error for CopyFiles@1?
On , Azure Pipelines shows a retirement error for CopyFiles@1, but the run does not fail. On , pipelines that still use CopyFiles@1 fail.
Find it in your pipelines
With trasloco:
trasloco modernize --check
Install trasloco from the latest release.
With plain grep, nothing to install:
grep -rniwF 'CopyFiles@1' --include='*.yml' --include='*.yaml' .
Before and after
Only the task line changes. Review the replacement inputs before you commit.
Before
- task: CopyFiles@1
After
- task: CopyFiles@2
CopyFiles@1 retirement FAQ
Is CopyFiles@1 deprecated?
Yes. CopyFiles@1 is retired on 2026-10-15. Azure Pipelines shows a retirement error, but the run does not fail until removal.
When does CopyFiles@1 stop working?
CopyFiles@1 is removed on 2027-03-15. Pipelines that still use it fail after removal.
What should I use instead of CopyFiles@1?
Replace CopyFiles@1 with CopyFiles@2.
Related retired tasks
- CopyPublishBuildArtifacts@1 — manual migration
- InstallAppleProvisioningProfile@0 — drop-in replacement