🦕 Fonts are carefully designed and offer a visual aid in communication, so the best way to display your project's advantages and its subtle or powerful features is through images. That is why we now include images on every font's Specimen page on Google Fonts.
This guide provides specifications for the images required for your typographic project published on Google Fonts. They will be added to the 'About' section of the specimen page, and — when a font is released for the first time on Google Fonts, or when it benefits from a major upgrade — we can use them to promote the font on social media platforms (Instagram, Mastodon, LinkedIn, Threads).
We encourage you to use these images to showcase your font’s main characteristics, design particularities, and any special features it might include. Don’t hesitate to use compelling shapes and colors that help users see its potential in different designs.
When a project includes many sibling families, please provide a compilation image plus one for each family. Depending on the project’s complexity, we will decide whether to promote them as a set or independently.
If the font was designed for a particular script or language, some localized text should be added addressing that script or language.
Do not include images that could be considered sensitive or offensive for social or political reasons (nothing that could be related to violence of any kind).
1 to 8 images would be great.
Credits and content
Please make sure that you have all the credits for the images.
Do not include images you don’t own 100% of the rights to.
Do not add credits of any kind, neither for third parties nor for yourself (the credits will already be included in the Designers section).
The images in this repository are licensed under the CC https://creativecommons.org/licenses/by-sa/4.0/. This license mention must be present in the repository, inside the documentation folder.
Where to allocate the images
Feel free to add these images to your repo’s README.md section (from the /documentation folder).
The images should be included in an article/ folder under the documentation directory. For more details, see the Documentation bullet in the Upstream repository structure.
An image-license.txt file must be included in the documentation directory. See the repository template.
Images for the About section
The ‘About’ section in the specimen of your typeface on Google Fonts gives a more detailed presentation of the project: its origins, inspirations, and uses. Please see the Article file section of this Guide for more details.
Supported formats: JPG, PNG and SVG, with a strong preference for JPG/SVG.
Maximum file size: 800 KB for SVG; 1.75 MB for other formats (enforced by the knowledge_graph.py GitHub workflow).
Recommended width: at least 1000px. Resolution: 72dpi.
Maximum resolution allowed: 1024 px (height) × 2048 px (width). Feel free to choose the ratio you want!
Videos can also be included: an MP4 (max 1.4 MB) or a YouTube link. See the Article file for the exact HTML format.
Social media promotion
When a font is released or significantly upgraded, we generally create posts on Instagram, Mastodon, LinkedIn and Threads. We use the images provided by the designers, or the images already in the repository — usually the same ones used for the About section.
If you would like a very specific post, please let us know and send us everything required. Even so, we cannot guarantee whether it will be published, or on what date.
You are welcome to look at the Google Fonts profiles for some examples:
These are guidelines; it is not necessary to create image formats for each platform (however, square versions are especially welcome for Instagram).
4 to 10 images would be great.
1,600 × 900 px (recommended), plus some square versions for Instagram.
Minimum size: 600 × 335 px.
Supported formats: GIF, MP4, JPG and PNG.
Maximum file size: up to 1.75 MB for videos and SVG; 800 KB for photos and GIFs.
Accepted aspect ratios per platform
Each platform accepts a range of aspect ratios (width ÷ height). Staying within these ranges avoids unwanted cropping:
Instagram: between 0.80 (4:5 portrait) and 1.91:1 (landscape). Square (1:1) is recommended.
Threads: up to 3:4 (0.75). Images taller than 3:4 are reduced in width to fit. Maximum display size: 1070 × 1424 px.
LinkedIn: 1.91:1 (1200 × 627 px). The image must be more than 200 px wide.
X (Twitter): between 1:1 and 16:9.
Mastodon (Typo.Social): 1:1 or 16:9.
Post text
We write the social media post based on the font description in the repo’s README file. Sometimes we have to shorten it to fit the social media specifications. If you prefer to provide your own, please follow this guide:
Describe the font, the design space, the language support, etc.
Please provide your social media profile, if you have one, so we can tag you. Person tags can be provided in the README.md or in a .txt file in the documentation directory.
Text length limits
X (Twitter): 500 characters max.
Mastodon and Threads: 500 characters max.
Instagram: 2,200 characters max.
Image formats and specifications per platform
(These are indications; not all the formats are mandatory.)
X (Twitter)
1 to 4 colorful images.
Supported formats: JPG, PNG, GIF.
Recommended ratio: 1:1 or 16:9. Images at 600 × 335 px can be clicked and expanded to 1200 × 675 px.
Mastodon (Typo.Social)
1 to 4 colorful images.
Supported formats: PNG, JPG, HEIF, WEBP.
Recommended ratio: 1:1 or 16:9 (e.g. 3840 × 2160 px).
Use a 1.91:1 ratio (1200 × 627 px). The image must be more than 200 px wide.
Images: JPEG, PNG / video: MOV, GIF, MP4.
Threads
1 to 10 colorful images.
The maximum image height is 1424 px. Images taller than a 3:4 aspect ratio are reduced in width to fit. The maximum display size is 1070 × 1424 px; this 3:4 ratio gives the most visual impact.