Modern Beamer theme revisited

According to the stars and forks1, the Beamer theme that I introduced a year ago has filled a longstanding desire for a theme that has a simple and clean default look. It started as a one man effort but over the year I received a lot of contributions from many people, first and foremost from Benjamin Weiss – author of the HSRM theme that was a huge inspiration for this theme – and Ross Churchley. With their help, the theme transformed from a stupid hack into a polished and highly customizable Beamer theme called Metropolis that is now available on CTAN2. In this post, I will quickly go through the most important changes.


Many aspects of the layout that were formerly hardcoded can now be modified using pgfkey-based package options. For example, to change the per-frame progress bar and disable the frame numbering, you can simply pass the following options when loading the theme


The color theme is also normalized and derives the entire look from only a few color specifications. For instance, to modify the general look you would change the normal text and alerted text colors:


% Theme colors are derived from these two elements
\setbeamercolor{alerted text}{fg=Orange}

% ... however you can of course override styles of all elements

Although, Metropolis is mostly recognized as a Fira Sans theme, the hard dependency quickly became a major pain point for some folks unwilling or unable to install Fira Sans. With the current version it is finally possible to compile a theme with PdfTeX or override the font as usual with

\setsansfont[BoldFont={Source Sans Pro Semibold},
              Numbers={OldStyle}]{Source Sans Pro}

You may have noticed that the frame title does not sport small caps by default anymore. We disabled them because there were too many problems lowercasing the title and typesetting the title with \textsc{}. However, if you are like me and prefer the small caps styling, you can get them back easily with


As you can see, \metroset{} can be used within the document to change options on the fly. Moreover, there is a second option for a semi small caps style, i.e. all uppercased letters have a slightly larger x-height:



Originally, the entire theme was documented using the top-level README. With a growing number of options this approach became a bit tedious and the README totally overcrowded. Moreover, distribution on CTAN and the likes recommends a proper manual in PDF format. Thus, we moved all documentation to a real manual and limit the README to installation and basic usage information. The manual itself is now derived from the documented TeX source.

The future

This is the first version in a series of stable releases, so you can expect a better theme – but still adhering to its core principles – soon. Nevertheless, the theme lives from outside contributions, be it code or bug reports, so do not hesitate to contact us on GitHub.

  1. As of now the repository has been starred more than 800 times and cloned by more than 150 people. 

  2. … and TeXlive and MikTeX. 


wolfgang wiley

All thumbs up. Great work. Enjoy the template


It looks really great!


I’m trying to use this on Sharelatex, but I can’t seem to get the fonts to work. I uploaded all the fira sans fonts in a separate folder, but beamerfontthememetropolis still can’t find it.


Could you please create a package for for ShareLatex and Overleaf?

Thank You.


Great beamer, and do enjoy the template.

I have two questions.

  1. Could I add page numbers, such as “ 3 / 17 “, in those section pages and subsection pages?

  2. On the top of this page, you mentioned how to set the color theme, for example, \setbeamercolor{frametitle}{bg=Purple}. Could I set the background color of section pages and subsection pages to that color, i.e., the background is dark, but the texts are light color?

Thank you very much.


Great theme! Thank you very much!


Downloaded it with MikTex and using it in Lyx. It works and looks great! I’m curious about an update with maybe more functions (even though I don’t miss anything special right now). Thank you for the effort!


@Royi: this is up to the maintainers but as far as I know there is a template for Overleaf.

@123: Please file feature requests on GitHub.

@Pete: well, if enough features accumulate, we do in fact release a new version which you could update via MikTeX ;-)


Is there any easy way to include frame subtitles?


Hi Riccardo, no there is no way to have frame subtitles at the moment.