On this page
Use patterns with Field templates
Last updated on
9 January 2025
This documentation is for UI Patterns 1.x only
UI Patterns 2.x, based on SDC, will be released soon and have its own documentation.
Patterns can be used as Display Suite field templates by enabling the ui_patterns_ds module. This opens the following interesting possibilities:
- Link fields can be styled as buttons by mapping their URL and link titles to specific pattern destinations.
- Image fields can be styled as an “image with caption” by mapping a formatted image and title to specific pattern destinations.
Let’s see how to implement the first example having the following pattern definition:
button:
label: Button
description: A simple button.
fields:
title:
type: text
label: Label
description: The button label
preview: Submit
url:
type: text
label: URL
description: The button URL
preview: http://example.comOn the entity display setting page we access the link field setting by clicking on the gear icon:
![]()
Then, after selecting the Pattern field template and the Button pattern, we map the link field columns to the pattern’s fields defined above:

Our multi-valued link field will then be formatted as follow:

Help improve this page
Page status: No known problems
You can:
You can:
- Log in, click Edit, and edit this page
- Log in, click Discuss, update the Page status value, and suggest an improvement
- Log in and create a Documentation issue with your suggestion