Change the maximum attachment size for work items

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:

    https://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).

Q & A

Q: What reasons are there to keep the attachment size at its default value?

A: 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.

Q: What web browsers are supported?

A: The following web browsers are supported: Internet Explorer, versions 9, 10, and 11; Safari, version 5 and 6; and the latest versions of Mozilla Firefox and Google Chrome.