Change the maximum attachment size for work items

Change the maximum attachment size for work items


Updated: July 15, 2016

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:


    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).

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.

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.

© 2016 Microsoft