How to install WP Notepad and use each feature.
Installation
- In the WordPress admin, go to Plugins → Add New.
- Search for “WP Notepad”, install and activate it.
- Or upload the distribution zip via “Upload Plugin” and activate.
Requirements: WordPress 6.0+ / PHP 7.1+.
Usage
1. Classic widget
Go to Appearance → Widgets and add the Notepad widget to a widget area. Settings:
- Title / Description
- Number of tabs (1 = no tabs)
- Auto-delete after (days) (0 = never)
- Tab names (comma-separated, optional)
- Placeholder text / Minimum height (px) / Maximum characters (0 = unlimited)
- Show character count (on/off)
2. Block
Insert the “WP Notepad” block in the post/page editor. You can enter a title and description, and adjust the following under “Notepad settings” in the sidebar:
- Placeholder text / minimum height (px) / maximum characters
- Show character count (on/off)
- Number of tabs / auto-delete days
- Tab names (when there are 2 or more tabs; comma-separated, e.g. “To do, Ideas”. Renaming a tab keeps its note)
Color, font size, line height, spacing, alignment (wide/full) and an HTML anchor can be set with the standard block editor controls. The block is rendered on the server, so its labels appear in the visitor’s language. A duplicated block gets its own storage key (a separate note).
3. Shortcode
Add [wpnotepad] to content or theme templates. Attributes:
| Attribute | Description |
|---|---|
id | Storage key (recommended when using more than one; auto-generated if omitted) |
placeholder | Placeholder text |
min_height | Minimum height (px) |
max_length | Maximum characters (0 = unlimited) |
show_count | Show character counter (true/false) |
tabs | Number of tabs (1 = no tabs, up to 20) |
tab_labels | Tab names, comma-separated (unnamed tabs show “Note N”) |
ttl | Auto-delete after this many days (0 = never) |
label | Accessible label (aria-label) for the textarea |
Example:
[wpnotepad id="my-note" placeholder="Jot something down" tabs="3" tab_labels="To do,Ideas,Notes" ttl="30"]
Notepad features
- Auto-save & restore: notes save to the browser as you type and are restored on return.
- Character counter: shows the character count below the textarea, or “used / maximum” when a maximum length is set.
- Auto-grow: the textarea expands to fit its content (also when it starts hidden, e.g. in a tab or modal, once it is shown).
- Copy / Download / Import: copy to clipboard, save as
.txt, or load from a file. Import reads text files up to 2 MB. Larger files and files that are not text (images, PDFs, etc.) are not read, and the note is left as it is (the reason is shown). If the note has text, you are asked before it is replaced. - Clear: empties the note after a confirmation and removes the stored data.
- Undo: right after a Clear, or after an import replaced the note, an “Undo” button appears and brings the previous text back. It goes away when you type, switch tabs or after 30 seconds. With sync on, the restored note is synced like a normal edit.
- Tabs: keep multiple notes in one notepad and switch between them. Tabs can be named and switched with the arrow keys, Home and End.
- Note expiry (TTL): notes older than the configured number of days are removed on next load.
- Live across browser tabs: a notepad open in several tabs or windows stays in step, as do notepads showing the same note on one page.
- Save warning: a warning is shown instead of “Saved” when the browser cannot store the note (storage full or blocked).
- Accessibility: labelled textarea, status messages announced to screen readers (live region) and keyboard support.
Cross-device sync (opt-in)
Disabled by default. When an administrator enables “cross-device sync” under Settings → WP Notepad, logged-in users’ notes are stored in their account (user meta) and synced across devices via the REST API.
- Only logged-in users are synced; guests always stay browser-only. If the site limits sync to some users (with a filter), the other users stay browser-only too.
- On conflict, the note with the newer timestamp wins (last-write-wins). A device whose clock is off is corrected using the server’s time.
- Edits are sent in batches rather than on every keystroke (and when the page is left); failed requests are retried.
- Shared computers: on a site that uses sync, notes written while logged in belong to that account. They are not shown to other accounts that log in on the same browser, nor to guests after logout, and notes typed while logged out are never uploaded into an account automatically.
- Per-user limits: 200 notes, 1 MB in total, 100,000 characters per note.
- While disabled, notes are never stored on the server. Turning sync off does not delete data that was already synced (use “Delete all” below).
Managing synced data
- Settings → WP Notepad shows how many synced notes (and users) are stored on the server and can delete them all (network administrators only on multisite).
- Synced notes are included in Tools → Export Personal Data / Erase Personal Data, and suggested privacy policy text is added under Settings → Privacy.
- Erased or purged notes are not uploaded again from browsers that still have a copy.
Multisite
On subdirectory multisite networks all sites share the same browser storage, so sub-site notes use a per-site prefix (site{ID}--) in their storage keys and never mix with other sites’ notes. The main site and single sites keep the original keys. Notes a sub-site showed in earlier versions are carried over automatically.