How to update an existing WordPress plugin SVN repository

This guide will show you how to update your WordPress plugin in the plugin directory using TortoiseSVN on a Windows 8 computer.  The steps below assume you are working from the same computer that has previously managed the plugin. If you need to setup TortoiseSVN again, follow steps 1-13 in How to upload a plugin to the WordPress SVN repository.

REMEMBER to update the readme.txt file to include the change log, including the updated version number and the changes in the revision. The version number in the main PHP file also needs to be updated.

  1. Update your plugin’s files in the Trunk folder.
  2. When an existing file is changed a red exclamation mark will appear over the file’s icon.
  3. WordPress-PluginDirectory10
  4. Once you are ready to commit the changes, right-click in a blank area of the trunk folder and select ‘SVN Commit’
  5. In the top field enter a suitable description to describe the update – for example, version 1.0.1.
  6. New files and the changes files will appear in the bottom field – make sure the files you want updated are selected
  7. WordPress-PluginDirectory11
  8. Click ‘OK’
  9. You will be prompted for your WordPress username and password – this is the same username and password for the WordPress forum and website
  10. Once the update has been made click ‘OK’ to save the changes.

    Step 2: Add revision to tags directory

  11.  From the trunk folder, right-click in a blank location and choose TortoiseSVN – > Branch/tag
  12. WordPress-PluginDirectory7
  13. In the ‘To path’ folder, change the location from /trunk to /tags/<version number>
  14. For example
  15. Enter a revision comment, e.g. version 1.0 – first public release
  16. WordPress-PluginDirectory8
  17. Click ‘OK’
  18. You will now be prompted for your WordPress username and password again – this is the same username and password for the WordPress forum and website
  19. Once done you will see a message like this
  20. WordPress-PluginDirectory9
  21. Click ‘OK’ to close the window
  22. You can now go into the tags folder, right-click and choose ‘SVN Update’ – this will download all the revisions (or the one you just uploaded) to your computer.

If you changed version numbers the plugin version number will change in the WordPress directory with 15 minutes. If the number does not update, see Version number not updating in WordPress Plugin Directory.

Each WordPress installation that has the plugin installed (and update checking enabled) will see this update within two hours (the default update checking time).

They will have the option to update to the latest version and will see what the changes are from the information you entered into the readme.txt change log – this is why leaving clear change descriptions is important.