How to download plugins on iOS/iPadOS

Currently (v3.0.26) it is not possible to download plugins directly in the iOS / iPadOS version of NotePlan. This might change in future releases.

You can download plugins on Mac (in the preferences > Plugins) and they will get synced automatically to your iPhone or iPad. This is the easiest way, if you have a Mac available. If you have no Mac available, see the workaround below.

Download Plugins on iOS

Plugins are stored in the same location as your notes, in a sub-folder called “Plugins”. You can open this folder using the Files app on your iPhone or iPad. 

You can download individual plugins from the official plugin repository: https://github.com/NotePlan/plugins/releases. A plugin consists usually of one configuration file and one script file.

Here are the steps:

  1. Go to the repository and find the plugin you want to download.
  2. Expand the list of files under “Assets” and download “plugin.json” and “script.js” (the name of the script file might be different). Usually, you would need at least those two files, but it might contain more scripts. You don’t need to download the “source code”.
  3. Go into the Files app and find the two (or more) downloaded files under “Downloads” and select them.
  4. Tap on “more” at the bottom right (on iPad) to create a new folder with the two items in there (you can also create the folder first and then move the files). Use the name of the plugin as the folder name (it’s not important how the folder is named):
  5. Now move the folder into NotePlan’s plugins location. You can find it in the Files app under “On my iPhone/iPad” > NotePlan > Plugins, if you are using CloudKit to sync. If you are using iCloud Drive to sync, you will find NotePlan’s folder in your iCloud Drive folders instead.

  6. Launch NotePlan and open the command bar (CMD+J or tap on the magnifier glass icon bottom right) or start typing into the text anywhere with “/“. You should see the commands from the downloaded plugin now and be able to execute them.