Skip to main content


np.Templating includes a variety of helper methods which can be used in your templates. In addition, some of there helpers have been added to np.Templating modules.

NotePlan Plugin Helper Methods

np.Templating has implemented globally-namespaced methods which were created using addTag method in nmn.Templates/src/templateController.js method to aid in migrating legacy templates to np.Templating. Those methods, provided by other plugins, are therefore still available for use in templates, through being compiled into np.Templating:

Helper Methodnp.Templating Module Method (where applicable)Comments
advice<%- web.advice() %>
affirmation<%- web.affirmation() %>
currentDate<%- %>
currentTime<%- %>
date8601<%- date8601() %>
date<%- %>Renamed to legacyDate during migration
now<%- %>
timestamp<%- date.timestamp() %>
quote<%- web.quote() %>
weather<%- %>
prompt<%- system.prompt() %>
pickDate<%- system.promptDate() %>Renamed to promptDate during migration
pickDateInterval<%- system.promptDateInterval() %>Renamed to promptDateInterval during migration

NotePlan Plugin Helpers

In addition to the built-in helper methods, if you are using one of the many NotePlan Plugins, additional helpers may be available


If you you see an error message when referencing a plugin command in your template, make sure the associated plugin is installed.

Helper MethodNotePlan PluginUsage Example
events() ๐Ÿ•“ Event Helpers
matchingEvents() ๐Ÿ•“ Event Helpers
progressUpdate() ๐Ÿ—ƒ Summaries
sweepTasks ๐Ÿงน Task Sweeper<%- sweepTasks({limit:{ "unit": "day", "num": 7 }}) %>
weekDates ๐Ÿ“… Date Automations<%- weekDates({format:'EEE yyyy-MM-dd'}) %>
date8601 ๐Ÿ“… Date Automations<%- date8601() %>

Using Custom Methods in Templates

If you have created your own NotePlan plugin and wish to use it's methods in a template, follow this example.

We have a method sayHello which would be referenced in a template as <%- sayHello('Mike') %>

import NPTemplating from 'NPTemplating'

export async function templatingHelloWorld(): Promise<void> {
try {
const templateData = {
methods: {
sayHello: (name: string = '') => {
return `Hello ${name}`
const result = await NPTemplating.renderTemplate('Template (Say Hello)', templateData)

} catch (error) {
console.log('templatingHelloWorld', error)

When using np.Templating in NotePlan Plugins, you should use the approach described in Example 3 - Custom Methods