Everything about the reMarkable Paper Tablet

User Tools

Site Tools




Customizing the Templates

The templates are PNG files and are located in /usr/share/remarkable/templates/ you add new templates by simply copying additional files to this folder using SSH Access.

As of at least version, copying files is not sufficient to make your templates appear. You also have to edit the file templates.json with your favourite text editor to include meta data for your newly uploaded file. For each template file, there's a section like for example

  "name": "Weekplanner US",
  "filename": "P Week US",
  "iconCode": "\ue9db",
  "landscape": "false", 
  "categories": [

These sections within curly brackets are separated with commas from each other. Just replace name with whatever caption you'd like to give your file. filename should be the file name of your PNG/SVG file without the extension. iconCode is a Unicode character from a webfont installed on your reMarkable that contains all the device's iconography (/usr/share/remarkable/webui/fonts/icomoon.woff). This value can simply be copied from another entry in the template file, but you are free to inspect the font and choose a specific icon from the set as well. It will show up as the thumbnail image above the template name. categories can be used to create an own custom category. Just name it accordingly.

The “landscape” option defaults to false, and can be omitted entirely if the template is to be used in portrait mode. However, if you want the template to appear under the 'landscape' section of the ReMarkable's template selection menu, set this option to “true”.

Alternatively you can use the free reMarkable Assistant or the paid eInkPads Template Installer with Drag n Drop functionality, or paid reMarkable Connection Utility which stores all metadata in the template file and automatically restores templates after system updates.

After modifying templates.json you need to restart xochitl for it to be reloaded:

systemctl restart xochitl


The templates are in the exact size of 1404×1872 pixels. The Menu Bar, if not closed, takes exactly 120 pixels on the top and on the left side.

If developing a custom template, the .png file is the image shown when drawing on the remarkable device. The .svg vector file will be used when exporting the template to .pdf via the USB web interface (Enabled under Storage Settings). The .svg file presumably must be in the SVG 1.2 Tiny profile.1)

Both template files must be in the exact resolution of 1404×1872 pixels regardless of whether the template is intended for portrait or landscape mode. Accessing the custom template export will not work properly from the reMarkable app 2.3.2 since custom templates are not synced to the remarkable server (although the notebooks themselves are).

Note: In the current version of the software (since software version, notes taken on a .png template with a transparent background will not properly erase over transparent portions of the template.

This image shows the various iconCode values for system


templatectl is a small CLI that manages edits to the JSON file for you. If you're using the version from Toltec, your added templates will also be preserved across system upgrades.

Change default Template

There was a tip posted on Reddit about changing the default template that is used for new notebooks.

The template Blank.png is set to be used as the default template when creating a new notebook.

To have another template make a backup of the original Blank.png (eg. rename to Original-Blank.png) and just to be sure make a copy on your computer in case of an update overwrite.

Then rename(or copy) the template you want to use as the default to Blank.png and you have a new default template!


There are scenarios where you will not be able to undo or erase strokes on your custom templates. To solve this, don't save your custom templates as PNG and SVG but as PDF.

Copy the PDF to your remarkable and then send it to yourself from the Remarkable. Once as PNG and once as SVG. Then copy these new PNG and SVG files to you Remarkable and the problem should be fixed.

Templates by other Users

<pattern>s do not work. As qtsvg is listed in the Copyrights and Licenses section and qtsvg implements SVG 1.2 Tiny which does not support <pattern>s, this seems to indicate that qtsvg is used for PDF creation.
This website uses cookies for visitor traffic analysis. By using the website, you agree with storing the cookies on your computer.More information
tips/templates.txt · Last modified: 2022/01/14 09:12 by studio_vds