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. 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.
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
imgix recommends using the Base64 variant version of this parameter to make encoding values easier.
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
When using multiple parameters to overlay images, parameter priority will dictate which parameter is shown over another. The order is as follows:
A parameter with a higher priority will be shown over parameters of a lower priority, e.g.
text will always be shown above
See the API specification for more information about this parameter's value ranges and format.