Text String

The text string to overlay on the image. This value must be supplied for text to be rendered—all other text parameters are ignored if it isn’t set. Using the txt parameter is best for single-line text. For multi-line text, please see our ~text documentation instead.

imgix has full support for UTF-8 characters, and will appropriately render non-Latin character sets and emoji (Unicode 15.0 support). This means that you can easily pipe in localized text to a base image instead of creating a different image for each language you want to support.

The txt parameter has the following defaults if none of the other text parameters are set:

• Position: Lower right corner
• Font: Helvetica
• Size: 12px
• Color: #000 (Opaque Black)
• Padding: 10px

Edit in Sandbox

Edit in Sandbox

Edit in Sandbox

Edit in Sandbox

Using Base64 encoding

Using Base64 encoding can help ensure you don’t run into issues when encoding text into URLs. This is especially important when doing more complex image compositions, where you pass collections of text parameters to the ~text endpoint.

Edit in Sandbox

Edit in Sandbox

Edit in Sandbox

Edit in Sandbox

Parameter priority

When using multiple parameters to overlay images, parameter priority will dictate which parameter is shown over another. The order is as follows:

1. text
2. mark
3. blend

A parameter with a higher priority will be shown over parameters of a lower priority, e.g. text will always be shown above mark, and mark above blend.