Understanding the Radio Option Group in Divi 5¶
The Radio design options control how radio button inputs look inside Divi 5 modules that include them. These settings cover the typography of the radio option text, the selection icon, spacing, background, border, and box shadow for the radio button container.
Overview¶
Where to Find the Radio Options¶
- Open the Module Settings: Click the gear icon or the module itself to access its settings.
- Navigate to the Design Tab: Locate the Radio option group.
Settings & Options¶
Input Text¶
Controls the typography of the text that appears next to each radio button option.
| Setting | Type | Description |
|---|---|---|
| Fields Font | Font selection | Choose a font from the Google Fonts library or upload a custom font. |
| Fields Font Weight | Weight selector | Set the weight from thin, light, regular, bold, and every weight in between. |
| Fields Font Style | Style options | Apply italic, uppercase, capitalize, underline, or strikethrough. |
| Fields Text Alignment | Alignment | Align text left, center, right, or justify. |
| Fields Text Color | Color picker | Pick a static color or assign a global color variable for sitewide consistency. |
| Fields Text Size | Unit input | Set the font size using any supported unit (px, em, rem, %, vw, vh, and more). |
| Fields Letter Spacing | Slider | Increase or decrease the space between characters. |
| Fields Line Height | Slider | Adjust vertical spacing between lines of text. |
| Fields Text Shadow | Shadow controls | Add a shadow behind the option text with control over horizontal position, vertical position, blur strength, and color. |
Spacing¶
Controls the space around and inside each radio button.
| Setting | Type | Description |
|---|---|---|
| Fields Margin | Spacing control | Add space outside the radio button on the top, right, bottom, and left. Click the chainlink icon to lock opposing sides together for uniform spacing. |
| Fields Padding | Spacing control | Add space inside the radio button (between the icon and the button edges) on the top, right, bottom, and left. Click the chainlink icon to lock opposing sides together for uniform spacing. |
Icon¶
Controls the indicator that appears inside a selected radio button.
| Setting | Type | Description |
|---|---|---|
| Fields Icon Color | Color picker | Set the color of the selection icon. Pick a static color or assign a global color variable. |
| Field Icon | Icon selector | Choose the icon shown when a radio button is selected. Select from the ET icon library or the Font Awesome library. |
| Use Custom Field Icon Size | Toggle | Toggle on to override the default icon size. When enabled, a size slider appears so you can set a custom value using any supported unit. |
Background¶
Controls the appearance of the radio button background. Divi 5 offers six background types, each available as its own tab. You can combine them (for example, a color base with a pattern on top).
| Setting | Type | Description |
|---|---|---|
| Background Color | Color fill | Apply a solid color fill. |
| Background Gradient | Gradient | Apply a multi-stop gradient with control over direction, type (linear or radial), and color stops. |
| Background Image | Image upload | Upload or link an image and adjust size, position, repeat, and blend mode. |
| Background Video | Video embed | Embed an MP4 or WebM video as a looping background. |
| Background Mask | Mask shape | Apply a pre-built mask shape over the background for layered visual effects. |
| Background Pattern | Pattern overlay | Overlay a repeating pattern on top of the background. |
Border¶
Controls the shape and edge of the radio button container.
| Setting | Type | Description |
|---|---|---|
| Fields Rounded Corners | Corner radius | Set the corner radius. Keep the chainlink icon locked for uniform corners or unlink it to round each corner independently. Radio buttons are traditionally circular, so keeping a high corner radius across all four corners preserves the expected shape. |
| Border Width | Pixel input | Define the border thickness (minimum 1px). |
| Border Color | Color picker | Pick a static color or assign a global color variable. |
| Border Style | Dropdown | Choose solid, dashed, dotted, double, groove, ridge, inset, outset, or none. |
Box Shadow¶
Adds a drop shadow around the radio button container to create depth. Pick from a library of preset shadow styles, or customize each property manually.
| Setting | Type | Description |
|---|---|---|
| Horizontal Position | Slider | Move the shadow left or right of the radio button. |
| Vertical Position | Slider | Move the shadow up or down from the radio button. |
| Blur Strength | Slider | Soften or sharpen the shadow edges. |
| Spread Strength | Slider | Expand or contract the shadow's reach. |
| Shadow Color | Color picker | Pick a static color or assign a global color variable. |
Tips for Using Radio Options¶
- Match Form Typography: Keep Input Text font, weight, and size consistent with the rest of your form fields so radio buttons read as part of the same group.
- Use Global Colors: Assign global color variables to Fields Icon Color and Border Color so sitewide palette changes update radio buttons automatically.
- Preserve the Circle: Users recognize radio buttons as round. Keep Fields Rounded Corners high on all sides unless you're intentionally styling against convention.
- Pick a Recognizable Selection Icon: A filled dot or solid circle from the ET or Font Awesome libraries reads most clearly as "selected" at small sizes.
- Size Icons Proportionally: When enabling Use Custom Field Icon Size, keep the icon smaller than the radio button container so it sits cleanly inside.
- Keep Tap Targets Generous: Use Fields Padding and Fields Margin to give radio buttons enough space for easy tapping on mobile devices.
- Ensure Contrast: Check that the icon color contrasts clearly with the radio button background so the selected state is obvious at a glance.
Related¶
- Composable Settings in Divi 5
- Understanding the Fields Option Group in Divi 5
- Understanding the Checkbox Option Group in Divi 5
Version Notes¶
Divi 5 Only
This page documents Divi 5 behavior exclusively.
