Change the maximum attachment size for work items

Last Update: 3/14/2017

TFS 2017 | TFS 2015

IMPORTANT

This topic applies to team project customization for the On-premises XML process model. This the Hosted XML process model, see Customize a process. For the Hosted XML process model, see WebLayout and Control elements.

For an overview of process models, see Customize your work tracking experience.

By default, Team Foundation Server (TFS) limits the size of work item attachments to 4 MB. For on-premises deployments, you can use the TFS web service to increase the size of files you attach to up to 2GB.

  1. If you're not a member of the TFS Administrators group, get added as one.

  2. Log on to the application-tier server for TFS.

  3. In a supported web browser, open the following URL:

    http://localhost:8080/tfs/DefaultCollection/WorkItemTracking/v1.0/ConfigurationSettingsService.asmx?op=SetMaxAttachmentSize

    If the team project resides on a different project collection, specify the name of the collection in place of DefaultCollection.

  4. Enter the size in bytes, and then choose Invoke.

    SetMaxAttachmentSize, ConfigurationSettingsService

    The maximum size you can specify is 2 gigabytes (or 2000000000).

Alternative solutions to increasing the attachment size

Increasing the attachment size increases the amount of data in storage and the time it takes to save a work item. To work around the size limit, add the attachment to source control and add a link in the work item to the source control file using the Versioned Item link type.