Large Media overview

Storing your site content in a Git repository is great until you start adding large files that aren’t made up of text — files like images, zip files, and PDFs. Git’s system of tracking diffs doesn’t work with these files, so it saves full copies of every version in your Git repository.

Netlify Large Media uses Git LFS to take advantage of the benefits of Git version tracking without bloating your repository. Your designated Large Media files are uploaded directly to our media servers while Git tracks their versions with text pointer files in the repository.

This saves local development time and speeds up builds in the following ways:

  • Smaller repositories – Whether you’re cloning for local development, or our buildbot is cloning to run your build, smaller repositories mean faster clones.
  • Separate uploads – Uploads to our Large Media service run in parallel with the build, so both processes can run as efficiently as possible.
  • Transformations when you need them – With our image transformation service, you can serve the exact image size you need for each context, from thumbnail to retina, without having to save multiple versions or run repetitive resizing operations in your build.

Large Media docs

Find the information you need about Netlify Large Media.

Requirements and limitations – Large Media changes how your Git repository works, so it's important to review the requirements and limitations before getting started.

Setup – Once you're clear on the requirements and limitations, head to setup to learn how to connect your site and repository with Large Media.

Repository collaboration – Learn about options for collaboration in repositories enabled for Large Media, including workflows using Git and Netlify CMS.

Transform images – With Large Media enabled on your site, you can use query parameters to have our servers transform images to the exact dimensions you need.

Usage and billing – Find out how Large Media service usage is metered on the usage and billing page.

Large media: Requirements

Large media: Limitations

Enabling Netlify Large Media

Large Media file tracking configuration

Large media: Checking which files are tracked

Large media: Troubleshooting

Large media: Migrating files from Git history

Contributing to a repository with Large Media enabled

Large media: Contributing by forking

Large media: Contributing without downloading Large Media files

Large media: Using with Netlify CMS

Large media: Repositories with multiple connected sites

Large media: Deleting a site with Large Media enabled

Large media: Usage and billing

Large media: Changing levels