Skip to main content
Last Reviewed: February 26, 2020

Install Plugins

Beginners guide on how to use the WordPress Dashboard, an SFTP client, and your text editor of choice to work quickly, safely and easily on Pantheon's Git-based platform.


This lesson demonstrates how to develop using the WordPress Dashboard in SFTP mode. We'll install a few plugins and submit each one to version control as individual commits.

  1. Navigate to Code in the Dev tab of your Site Dashboard. Confirm your Connection Mode is set to SFTP.

  2. Now log in to your Dev site by clicking the Site Admin button.

    Add new plugin

  3. On the left admin menu, select Plugins, then Add New.

  4. Search for the Yoast plugin, then click Install Now:

    Install Pantheon Advanced Page Cache plugin

    If you encounter a prompt for FTP credentials, you're either working on the wrong environment or you're using the wrong connection mode. Don't try to authenticate FTP prompts within the WordPress Dashboard, it won't work (by design). Using the WordPress Dashboard to add or modify code is only allowed using the SFTP connection mode on the Dev environment.

  5. Return to the Pantheon Site Dashboard and click the yellow notification to review file changes as a result of our actions in the WordPress Dashboard:

    View file changes prompt

    You should see the following files for our recently installed plugin:

    View advanced page cache plugin files

  6. Rather than piling a bunch of changes on top of this plugin, get into the habit of saving code in small incremental amounts with meaningful commit messages.

    Write a message that summarizes your work to let your team (and your future self) know what these changes do and which feature(s) they pertain to. For example, Add Yoast plugin Version: 5.7 is much better than New plugin or asdfasdf.

    Click Commit to submit work from the WordPress Dashboard to Git in the Site Dashboard:

    Commit advanced page cache plugin files

  7. For practice, add these plugins next, each with their own commit message. These plugins allow your site to take advantage of some of Pantheon's performance optimizations:

    • Pantheon Advanced Page Cache

    • WordPress Native PHP Sessions

    • Pantheon HUD

      The commit log within the Pantheon Site Dashboard should look something like this:

      Several Plugins Added

    Learn more about these plugins

    Pantheon Advanced Page Cache

    Automatically clear related pages from Pantheon's Global CDN when you update content. Without this plugin, pages expire from cache after 10 minutes (600 seconds) by default. This plugin allows fresh content to be immediately served to anonymous visitors.

    WordPress Native PHP Sessions

    This plugin provides a more scalable way to handle sessions than PHP's default session manager. Some plugins will require this to run on Pantheon's distributed infrastructure. For more details, see WordPress and PHP Sessions.

    Pantheon HUD

    Provides situational awareness within the WordPress Dashboard when working on the Pantheon platform. It's helpful to have a reminder of which environment you're in, as well as quick access to links to get back to Pantheon's Dashboard, or to interface with your WordPress installation via the command line:

    Pantheon HUD

Bam! You just nailed our first demonstration of using version control with WordPress on Pantheon sites. Follow this same approach to update plugins and for any other development tasks you normally handle in the WordPress Dashboard.