Add Git to Your Workflow

Contributors: Scott Massey, Rachel Whitton

This guide demonstrates how SFTP users can build WordPress sites on Pantheon's git-based platform. Don't use git? No problem -- we'll show you how easy it is to use by demonstrating workflows for various development tasks, such as adding a new theme or plugin.

Dive into Git with WordPress on Pantheon, keeping your favorite SFTP client and text editor without compromising use of the WordPress Dashboard or adding a lot of complexity to your workflow. But first, why should you use git, when SFTP and a text editor has been working fine? Here are a few reasons why:


Any kind of collaboration is easier and safer with version control. You can work in parallel with others and not step on any toes. Even working alone, you can have many features in progress on a site, but without risking the stability of the current site.


Version control creates a more secure way to move code around. You can lock down your production environment, because you are never touching the code directly; you're deploying it securely with git.


Git provides a recorded timeline of changes, allowing you to move forward or back in the code's history. What caused that new bug? Simply step back through past revisions until you find where it appears!

Best Practice

Using Git is a big step away from the bad habits of Cowboy Coding and a leap towards professional development best practices. For growing agencies and developers, it isn’t an option, it's inevitable. And here is the easiest way to embrace your destiny as a WordPress professional.

Before You Begin

Make sure that you have a:

Demonstrations throughout this guide use Atom and Transmit. For fastest development, choose an SFTP client that uploads on save, and allows you to authenticate with an SSH key. Creating a key takes a few minutes and handles the server authentication for you. Alternatively, you can use your Pantheon account password to sign in, when prompted.

Cloud Development Environment

Ok, yay, let’s do this. Let me fire up and configure my local development environment, give me one to three hours. -- You, probably.

Hold it right there. Sites on Pantheon each include Dev, Test, and Live environments -- and as the name implies, Dev is already set up for development purposes! Rather than managing and maintaining a LAMP stack on your local computer, you can do your work in the cloud, directly on our platform, with zero setup and no ongoing responsibilities.

Using the Dev environment means you can:

  • Build in a known state with fewer surprises, since Dev is the same as Live.
  • Share work in progress with a web accessible URL (e.g.,
  • Stop Cowboy Coding