Skip to content

Upgrading your site to the latest version of TiddlyWiki

Simon Baird edited this page Sep 28, 2022 · 9 revisions

1. Download your site

  • Make sure you're logged in to Tiddlyhost then click "Home" to view your sites list
  • Find the site you want to upgrade, click its "..." actions menu and then click "Download"
  • Identify where the downloaded file was saved. Usually it's in your "Downloads" directory but it depends on your browser

2. Upgrade the downloaded TiddlyWiki file

  • Visit https://tiddlywiki.com/upgrade.html
  • Click the big button to upload your TiddlyWiki
  • Find the TiddlyWiki file you just downloaded and select it
  • Review the list of tiddlers being imported. (I think it's generally safe to leave the default selections as they are)
  • Click the "Upgrade" button
  • Click the green "Save upgraded TiddlyWiki button" which should cause a new file to be downloaded called "upgrade.html"
  • Identify where that file was saved. Once again it's usually the "Downloads" directory

3. Verify the upgrade

  • Open the newly downloaded "upgrade.html" file and make sure it works as expected. It's likely to work fine, but there might be plugin or other compatibility problems, so it's worthwhile checking

4. Upload the new TiddlyWiki file to your Tiddlyhost site

  • Back on the sites list, find the site you're upgrading, click the "..." actions menu and select "Upload". Tip: Be extra careful to choose the correct site
  • Click the "Choose file to upload" button and select the new "upgrade.html" that you verified in the previous step
  • Click the "Upload file" button and click "Ok" to confirm

5. Confirm the upload was successful and that everything is working

  • View your newly upgraded site online at its usual Tiddlyhost url. Make sure you hit reload to ensure you have the latest freshly updated version
  • Optionally you can verify the TiddlyWiki version by putting <<version>> inside a tiddler's content and seeing what it says
  • Click the save button and confirm that the site saves as per usual
  • (In the unlikely event that something is broken at this point, you can restore the previous version of your site by redoing the upload step and selecting the originally downloaded TiddlyWiki file instead of the upgraded file)
  • FAQ - a list of frequently asked questions
  • Journal - A few notes on what what's new and interesting
Clone this wiki locally