FAQ

General questions

How can I figure out which version of the typeface I have installed?

Mac OS: Use either the Font Book app or a terminal command like otfccdump MonoLisa-Regular.ttf | jq .head.fontRevision . The command depends on otfcc and jq.

Linux: The same terminal trick works under Linux as well.

As a general solution, you can use the FontDrop web service.

Will fixes made to version 2 be available for version 1 as well?

In technical terms, versions one and two have been built differently. The biggest underlying change is that now the typeface is authored using Glyphs 3 (2 earlier) and it’s variable by definition. In other words, the weight of typeface became freely adjustable starting from version two. Because of the shift, all the fixes and improvements will go only towards version two as it would not be feasible to maintain both versions in parallel.

There’s an upgrade path available for version one users. If you bought it later than 1st of May 2022, the upgrade is free for you, otherwise you’ll receive a 50% discount for the version two within the same tier. See the orders page for further details.

Are themes visible on the site included to the font distribution?

No, please see the theme collection related to your IDE to find close alternatives. Examples: VS Code, xcode, WebStorm.

The download doesn’t work. What can I do?

In some cases, the download might not work and give an error like net::ERR_CONTENT_LENGTH_MISMATCH 200. This has been known to occur if your corporate network uses software like Zscaler. To work around, please download the font outside of your corporate network (e.g., home).

Is there a student discount?

To apply for a student discount, send proof of your student status to our email and we’ll see what we can do. A photo of your student card would be enough.

Can I try the font beforehand?

Yes, there’s a limited trial available. Note that it is missing majority of the features. See the playground as well.

Orders

How to upgrade to a higher tier (plus/complete)?

You can upgrade by visiting My Orders page. We will deduct the amount you have already paid for earlier tier products. The same applies also for student licenses.

If you are on version 1, you have to upgrade to version 2 of the same tier first before you are able to upgrade to a higher tier of version 2.

How to change the email of my order?

Please ask the Paddle support to do this for you as they manage the data related to the orders.

Can I get a refund for my order?

See the refund policy for the exact terms and conditions.

I want to buy licenses for my team/company. How can I do that?

Starting from 2.0, we have yearly subscriptions available for businesses at different levels. A company could for example buy a yearly license for itself or a team. See the buy page for the specific plans.

How can I upgrade from version 1 to version 2?

There are a couple of options depending on when you bought the original typeface:

  • If you bought v1 within six months from the release (starting from 1st of April 2022), the upgrade is free for you and you can complete it at the orders page. The free upgrade is towards the same tier. Note that for the personal plan, the upgrade is called Basic now due to a naming change.

If you decide not to upgrade, you still have access to the original typeface and the associated features (i.e., the customize tool). It simply won’t receive any updates. The discount is perpetual and you may redeem it at any time.

License

Can I use the personal license for programming at my job/company?

Yes, no problem.

Can I use the personal license on my phone/tablet?

Yes, no problem.

Am I allowed to customize the personal version?

Yes, you are allowed to customize (i.e., replace glyphs, apply Nerd Fonts) the personal version as long as you keep the changes private (i.e., within a private GitHub repository).

Features

Which weights/formats are included to each package?

The exact weights have been listed below:

  • Basic – Regular (400), Bold (700). The plan is available in ttf.
  • Plus – Light (300), Regular (400), Medium (500), SemiBold (600), SemiBold (700). The plan is available in ttf.
  • Complete – Thin (100), ExtraLight (200), Light (300), Regular (400), Medium (500), SemiBold (600), Bold (700), ExtraBold (800), Black (900). On top of this, the Complete version is available in a variable format (no fixed weight). The plan is available in both ttf and woff2 for web usage.

You can download your purchases package at the orders page.

💡

Note that the Plus and Complete packages contain more alternative glyphs and have access to the customize tool that makes it easy to generate custom versions of the typeface even per application. This way you can avoid software limitations and use exactly the features you want.

Settings & usage

What languages does MonoLisa support?

MonoLisa currently supports following languages:

Abenaki, Afaan Oromo, Afar, Afrikaans, Albanian, Alsatian, Amis, Anuta, Aragonese, Aranese, Aromanian, Arrernte, Arvanitic, Asturian, Atayal, Aymara, Azerbaijani, Bashkir, Basque, Belarusian, Bemba, Bikol, Bislama, Bosnian, Breton, Bulgarian Romanization, Cape Verdean, Catalan, Cebuano, Chamorro, Chavacano, Chichewa, Chickasaw, Chinese Pinyin, Cimbrian, Cofan, Cornish, Corsican, Crimean Tatar, Croatian, Czech, Danish, Dawan, Delaware, Dholuo, Drehu, Dutch, English, Esperanto, Estonian, Faroese, Fijian, Filipino, Finnish, Folkspraak, French, Frisian, Friulian, Gagauz, Galician, Ganda, Genoese, German, Gikuyu, Gooniyandi, Greek, Greenlandic, Guadeloupean, Gwichin, Haitian Creole, Han, Hawaiian, Hiligaynon, Hopi, Hotcak, Hungarian, Icelandic, Ido, Igbo, Ilocano, Indonesian, Interglossa, Interlingua, Irish, Istroromanian, Italian, Jamaican, Javanese, Jerriais, Kaingang, Kala Lagaw Ya, Kapampangan, Kaqchikel, Karakalpak, Karelian, Kashubian, Kikongo, Kinyarwanda, Kiribati, Kirundi, Klingon, Kurdish, Ladin, Latin, Latino Sine, Latvian, Lithuanian, Lojban, Lombard, Low Saxon, Luxembourgish, Maasai, Makhuwa, Malay, Maltese, Manx, Maori, Marquesan, Meglenoromanian, Meriam Mir, Mirandese, Mohawk, Moldovan, Montagnais, Montenegrin, Murrinhpatha, Nagamese Creole, Nahuatl, Ndebele, Neapolitan, Ngiyambaa, Niuean, Noongar, Norwegian, Novial, Occidental, Occitan, Old Icelandic, Old Norse, Oshiwambo, Ossetian, Palauan, Papiamento, Piedmontese, Pinyin, Polish, Portuguese, Potawatomi, Qeqchi, Quechua, Rarotongan, Romanian, Romansh, Rotokas, Russian, Sami, Sami Inari, Sami Lule, Sami Northern, Sami Southern, Samoan, Sango, Saramaccan, Sardinian, Scottish Gaelic, Serbian, Seri, Seychellois, Shawnee, Shona, Sicilian, Silesian, Slovak, Slovenian, Slovio, Somali, Sorbian Lower, Sorbian Upper, Sotho Northern, Sotho Southern, Spanish, Sranan, Sundanese, Swahili, Swazi, Swedish, Tagalog, Tahitian, Tetum, Tok Pisin, Tokelauan, Tongan, Tshiluba, Tsonga, Tswana, Tumbuka, Turkish, Turkmen, Tuvaluan, Tzotzil, Ukrainian, Uzbek, Venetian, Vepsian, Vietnamese, Volapuk, Voro, Wallisian, Walloon, Waraywaray, Warlpiri, Wayuu, Welsh, Wikmungkan, Wiradjuri, Wolof, Xavante, Xhosa, Yapese, Yindjibarndi, Zapotec, Zarma, Zazaki, Zulu, Zuni

The script variant doesn’t work. What can I do?

To debug why the script variant (ss02) doesn’t work or show up, follow the steps below:

  1. Make sure both normal and italic versions are installed to your system. It’s the italic version that includes ss02.
  1. If you use VS Code, make sure to use the non-customized version (i.e., download without customizing). You can find more specific instructions below at the VS Code section on how to do this and how to enable ss02 then.
  1. If you use an editor that doesn’t let you enable ss02 (IntelliJ etc.), please use the customize tool to freeze it to the font itself at your order page.
  1. To see ss02 in action, make sure to use text with italics applied to it as otherwise it won’t render. Depending on the editor, you may have to change the font for comments or the code feature where you want to use ss02.
  1. If in doubt, use fontdrop to verify that the feature is available in the version you downloaded. After dropping the italic version there, you should see a toggle for ss02. After pressing it, you should see the script variant applied to the sample. If you froze the feature through customization, it should be enabled by default.

Downloading

How to download the typeface?

You can download the latest version in “My orders” section by providing the email you used during the checkout and the order number.

How can I download the latest version of the typeface?

You can download the latest version in “My orders” section by providing the email you used during the checkout and the order number.

Usage

How to install the typeface?

Before installation, make sure to remove any possible earlier version of MonoLisa to avoid potential issues between different versions (esp. 1 and 2).

Windows

See installing fonts on Windows

Linux

Please refer to the documentation of your Linux distribution.

iPad/iPhone

Please use an application like Fontcase to import the font assets from iCloud or Dropbox and then apply the profile through Settings app. This blog post explains the process in more detail.

macOs

To install:

  1. Select and open all downloaded files (.ttf)
  1. Click on “Install font”

To uninstall:

  1. Open Font Book.app
  1. Find MonoLisa using search
  1. Right-click on it and choose Remove “MonoLisa” Family
  1. Empty trash bin

To update:

  1. Download the latest version of the font from the orders page
  1. Remove the old version of the font using Font Book.app
  1. Install the newer version of the font

You might need to restart your computer to see the newer version of the font in your editor. If that doesn’t work, please see next question.

To clear the font cache:

  1. Run the following in Terminal.app
sudo atsutil databases -remove
atsutil server -shutdown
atsutil server -ping
  1. Restart your computer
  1. Re-install the font (see previous question)

Please refer to these instructions if you still can’t update the font.

How to use the typeface in program X?

Generally put, the editor support for special features included in MonoLisa is weak. VS Code documented below is an exception to this rule. For the rest, it’s preferable to use the customize tool to generate a typeface that makes sense for your use case.

The same goes for terminals as majority of them don’t expose many font features and you are lucky if you can toggle ligatures.

Design software tends to have better support (esp. Adobe products, Figma, and Affinity Designer). For something more presentation oriented, such as Pages, using the customize tool is the way to go again.

How to enable alternate zero, stylistic sets, and the script variant?

Some OpenType features of MonoLisa are optional and they are hidden behind stylistic sets. At the moment, editor support for the feature is unfortunately poor.

VS Code

In VS Code the example below, we enable calt glyphs (space alterations), disable ligatures (liga), enable the alternate zero (zero) and the script variant (ss02) at settings.json:

{
"editor.fontLigatures": "'calt' on, 'liga' off, 'zero' on, 'ss02' on"
}

The editor.fontLigatures accepts standard CSS.

Other programs

To mitigate the problem for the rest of the programs, additionally you can customize your font before downloading it (plus plan or above). This allows removing ligatures or enabling script variant by default for any editor.

For the basic edition, please use fonttools-opentype-feature-freezer, MuTsunTsai/fontfreeze, or a comparable tool.

How to enable slashed zero in the basic version?

For editors that don’t support stylistic sets, please use fonttools-opentype-feature-freezer, MuTsunTsai/fontfreeze, or a comparable tool to freeze zero to the font.

How to enable superscript and subscript characters?

Both superscript and subscript versions of numbers are included by default and visible at the specimen page. The page also includes their UTF codes and Stack Overflow provides help on how to type them.

Where can I find the script glyphs (ss02)?

It’s important to note that the script glyphs have been defined only for the Italic variant of the typeface, not Normal. You can verify this behavior by looking at the specimen page.

Terminal

How to enable Nerd Fonts with MonoLisa?

Nerd Fonts is a popular collection of icons that can be patched to a font you use and the same process works with MonoLisa.

There are two ways to make Nerd Fonts work with MonoLisa: fallback and patching. The fallback approach is preferable as then you don’t have to touch the font files when upgrading and using fallback has been covered at Nerd Fonts documentation (works for Windows, Linux). There’s more information available about fallbacks (Kitty terminal, VS Code) at described in this issue comment.

In case the fallback approach doesn’t work for you and you want to patch, consider using daylinmorgan/monolisa-nerdfonts-patch . To avoid so called backtick issue, make sure you are using at least version 2.2.2 of Nerd Fonts.

How to enable stylistic sets for the Kitty terminal?

Use the following configuration (adjust font name to match the one on your system):

kitty.conf:

# ref: https://sw.kovidgoyal.net/kitty/conf/#opt-kitty.font_features
font_features MonoLisa-Medium +zero +ss04 +ss07 +ss08 +ss09
font_features MonoLisa-MediumItalic +zero +ss04 +ss07 +ss08 +ss09
How to setup the progress bar glyphs in a terminal?

WebStorm

What are the suggested settings for WebStorm?

Go to Preferences → Editor → Font and set the font to MonoLisa. Adjust the remaining options to your liking.

Preferences → Editor → Font
Preferences → Editor → Font

Visual Studio Code

What are the suggested settings for Visual Studio Code?

Make sure you are using the non-customized version with VS Code as it’s not needed there. You can customize which font features are used through configuration:

settings.json

{
"editor.fontFamily": "MonoLisa", // Or "'MonoLisa'"
// When lineHeight is set to zero, VS Code will figure out the
// the height automatically based on the font
"editor.lineHeight": 0,
// You can use standard CSS syntax here. To enable
// ss01 for example, you could set "'ss01' on"
"editor.fontLigatures": true,
"editor.fontSize": 12
}

Note that if you have customized the name and use a whitespace in it, it’s preferable to escape the name (i.e., "'MonoLisa Custom'"). See the font-family CSS rule for specifics.

How to make italics show up in Visual Studio Code?
How to enable the script variant for comments or function names?

Make sure you are using the non-customized version with VS Code as it’s not needed there.

To make the script variant work, make sure ss02 is enabled and that italic font style is being applied to your theme. The configuration below does this globally for VS Code:

settings.json

{
"editor.fontFamily": "MonoLisa", // Or "'MonoLisa'"
"editor.fontLigatures": "'ss02' on",
"editor.tokenColorCustomizations": {
"textMateRules": [
{
"scope": "comment",
"settings": {
"fontStyle": "italic"
}
}
]
}
}

See the related Stack Overflow question for more information and the customize-ui VS Code plugin.

How to change the font weight? How to enable variable weight?

In order to alter the font weight, you should use the editor.fontWeight field like this:

settings.json

{
// This works for both fixed weights and variable
"editor.fontFamily": "MonoLisa", // Or "'MonoLisa'"
"editor.fontWeight": 400,
// If you are using the variable version, set fontVariations: true
// After setting this, you can use any fontWeight between 100 and 900
"editor.fontVariations": true
}

Adjust the number based on the fonts you own. 400 is regular and the rest are with 100 increments (300 for light for example and 700 for bold). There’s more information about variable fonts in VS Code in this issue.

How to make MonoLisa take less vertical space?

If the default line height of MonoLisa feels too roomy for you, try adjusting it in VS Code like this:

settings.json

{
"editor.lineHeight": 16
}

Tweak the number till it looks good to you. You can use zero to use the default measurement to compare.

What Developers Say

Gant Laborde
Gant LabordeCIO at Infinite Red

As a consultant, an instructor, and a presenter, having a clean and engaging mono font is paramount, and MonoLisa delivers information perfectly to everyone without forgetting to sneak in some personality in a gentle smile.

Kyle Welch
Kyle WelchSenior Software Developer at Eventbrite

MonoLisa is now my go to font for all places. It has become my expectation in my terminal and code to the point that seeing other fonts confuses me. From the well designed and unique characters make it simple to parse and read throughout the day.

Horacio Herrera
Horacio HerreraIndependent consultant

This font is so sharp that the readability of my code increased a lot! Definitely a font I will use for a long time.

Max Stoiber
Max StoiberFrontend Developer at Gatsby

I love it ♥️

Mark Dalgleish
Mark DalgleishDeveloper at SEEK

I’ve been using MonoLisa as my editor font for the past few months. After a small adjustment period, I really grew to love it. Going back to any of my old font choices feels like a downgrade in comparison.

David Khourshid
David KhourshidSoftware developer at Microsoft

I’ve been using this font for months, and while the slightly wider nature of this font took a little getting used to at first, it eventually grew on me and I saw how well this font works with my daily workflow. A great, quality font and I highly recommend it!

Sara Vieira
Sara VieiraEngineer at CodeSandbox

As someone with an eye condition this font makes my life way easier. And not just in coding but even in design since it doesn’t only carry regular but the whole set of weights so you can even use it in design, logos or anything a monospace font makes sense.

Cassidy Williams
Cassidy WilliamsCTO at Contenda

I switched to MonoLisa after trying out several different fonts in my terminal and in my IDE. As a coding instructor and speaker (and just someone who codes a lot in her free time), readability is always the most important thing to me in a font.

Kent C. Dodds
Kent C. DoddsMaking people's lives better with software

I’m not much of a font guy, but after using this font for just a few days it’s grown on my and I really like it. (And people wasted no time in constantly asking me what font I use). Two thumbs up 👍👍

Dominik Sumer
Dominik SumerCo-Founder of seriouscode.io

Love the aesthetics of the font and how it improves code readability. That’s why we’ve also decided to use it as the default font at snappify.io

Michał Popek
Michał PopekFrontend Developer

I had been struggling with some vision issues before and MonoLisa really helped me a lot by taking a lot of strain off my eyes.

Caleb Porzio
Caleb PorzioCreator of Alpine.js

MonoLisa is the perfect coding font IMO. Spacious, stylish, and super readable. I never pictured myself having such strong feelings about a font, yet here we are.