> For the complete documentation index, see [llms.txt](https://help.mimeeq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.mimeeq.com/configurator/options-and-widgets/custom-fonts.md).

# Custom Fonts

Learn how to upload custom fonts, create font groups, and use them in Mimeeq.

Mimeeq provides a variety of default fonts, and you can also add your own. Additionally, you can organize fonts into groups for easier access, such as in the Text & Engraving Widget. This article will guide you on how to upload custom fonts, create font groups, and use them in Mimeeq.

## How to Upload a Custom Font

1. Go to the Media Library.
2. Open the system folder named "Fonts".
3. Click on "Upload new files" and add your font.

{% hint style="warning" %}
Accepted formats: .otf, .ttf, .woff, or .woff2. Note: ZIP packages cannot be uploaded.
{% endhint %}

![Media Library -> Fonts -> Upload New Files](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FFOpPONdLYUqB3IToaQ3Y%2Ffonts-image-1_1co67p5.png?alt=media)

Please note that installing new fonts may take a few minutes. Once uploaded, you can either assign the font to a Font Group or use it as a single font.

If you plan to use different font styles, such as Regular, Bold, Italic, etc., we recommend uploading each font style file separately. For example, you could create a folder named "Inter" and upload Regular, Bold, Italic, Thin, and other styles there. If you upload each style separately, you will achieve a 100% expected result when adding the Engraving option to your product.

However, if you upload only one style, such as Inter Regular, and then select multiple styles (like Bold, Italic, etc.) in the Engraving widget's Font Style Options, the result will be generated automatically and may not be what you want or expect, potentially leading to discrepancies.

{% hint style="warning" %}
If you plan to use multiple font styles, make sure you upload all of them to the Media Library. However, if you only need one font style, uploading that single style will be enough.
{% endhint %}

![How to upload different styles of the Font](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FjY7J0z5SZu9RYvIt82vm%2Ffonts-image-7_11nlhgt.png?alt=media)

## How to Add Fonts to a Font Group

Adding your font to a group is an optional step. This might be useful, for example, if you want to select a Font Group at the product level to be used in the Text & Engraving Widget. This means you won't have to manually select fonts for each product; instead, you can simply use the group for this purpose. However, you can still choose to use a single font for your product if that is your goal.

To add a font to a group, you will need:

1. Open Settings, go to the "Font Groups" under the Data section, and click on "New Group".
2. Assign a unique and descriptive name to your group.
3. Once named, you will be redirected to the Font Group details page.

![How to create a Font Group](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FbMHM3ZKoVeYRMzEjd5X5%2Ffonts-image-2_1x77i42.png?alt=media)

4. Click "Add Font" to assign fonts to your group.

![How to add fonts to the Font Group](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FszirG8jouEPPRnjgDkb0%2Ffonts-image-3_1g2mrkv.png?alt=media)

5. Select the fonts you wish to assign from the list, which includes both Default and Custom fonts uploaded in the Media Library. Use the Search and Filter by "Default" and "Custom Font" to speed up the process.

![How to add fonts to the Font Group](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FlmTLrZV8bWLiP3xUbkdG%2Ffonts-image-4_8jpp5v.png?alt=media)

## Using a Single Font or Font Group in the Text & Engraving Widget

In the Text & Engraving Widget, you can now pick a Font Source. By default, "Single Font" is chosen, which lets you select one font (either a default or a custom one) to use for this product. In this case, the end user will not be able to choose a font and will use the font you have selected.

![How to use the Single Font](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FrpfdSgHm884MfNc5fbj9%2Ffonts-image-61_dw7cvn.png?alt=media)

Alternatively, you can choose "Font Group", which allows end users to pick any font from a group you set up. After selecting "Font Group", you'll see a setting icon next to title. Clicking this icon will take you to the Font Group Settings, where you can make changes to the group before saving the product.

![How to use the Font Group](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FDLKXiDUKGdROi4pv4A7m%2Ffonts-image-5_mz6y66.png?alt=media)

## How to Customize Fonts in PDF

To select the font family to be used in the PDF, navigate to Settings -> Embed Templates. Choose the embedded template where you want to apply changes, then scroll to the PDF Settings section. There, you will see a dropdown menu where you can pick the font you want to use. You can choose from the default fonts or from custom fonts that you have uploaded to the Media Library.

![Customizing Fonts in PDF](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FYbcfWIfOZQRJy18f25PZ%2Ffonts-image-7_1aqfds8.png?alt=media)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.mimeeq.com/configurator/options-and-widgets/custom-fonts.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
