Forms module
Form Styler block
Shows a Contact Form 7 or WPForms form, styled to match your design.
Overview
Form Styler displays a form you built with Contact Form 7 or WPForms and restyles it — field style, labels, button — to match the rest of your site, without writing CSS. The form itself (fields, emails, spam protection) is still managed in that plugin.
At a glance
- Block name
wpbb/form-styler- Module
- Forms
- Find it by searching
- Form Styler
- Works with
- Contact Form 7 or WPForms (Lite or Pro) must be installed and active.
- Loads JavaScript on the site
- No
When and why to use it
- Contact, quote and booking forms that match your brand.
- Newsletter or feedback forms built in WPForms.
Example scenarios
- Contact page: Contact Form 7 “Contact form 1”, Filled fields, full-width button, coral button hover in the Styles tab.
How to add the Form Styler block
- Open the editor. In your WordPress dashboard go to Pages (or Posts) and click the page you want to edit, or click Add New. For headers, footers and templates, use Appearance → Editor (block themes).
- Add a new block. Click the blue + (Block Inserter) button in the top-left corner, or the small + that appears where you want the block. You can also type / on an empty line.
- Search for the block. Type Form Styler in the search field. Brigade Blocks appear in the Brigade Blocks category and show the coral block icon.
- Insert it. Click Form Styler in the results. The block appears with a form picker.
- Configure the content. Choose the form plugin and the form in the Settings tab (or in the picker on the block). The form preview then appears in the editor.
- Customise the design. Switch to the Styles tab (half-filled circle icon) to change colours, spacing, borders and more — see Design & styling.
- Save or publish. Click Save draft to keep working later, Preview to check it, or Publish / Update to make it live.
Content settings
You set up this block in two places: on the block itself in the editor, and in the Settings tab (gear icon) of the sidebar on the right. Every option is listed below, with its default value.
Settings panel: Form
If neither plugin is active, the block says “Install and activate Contact Form 7 or WPForms to use this block.”
Form plugin
- What it does
- Which plugin the form comes from.
- What to enter or choose
- Plugins that are installed but not active show “(not active)”.
- Default
- Contact Form 7
- How to use it
- Open the dropdown and pick an option.
- When to use it
- If both plugins are active.
- Example
- WPForms.
- Result
- The form list updates.
Form
- What it does
- The form to show.
- What to enter or choose
- One of your forms (“— Select a form —”).
- Default
- 0
- How to use it
- Open the dropdown and pick an option.
- When to use it
- Always.
- Example
- “Contact form 1”.
- Result
- The form appears. Without a form, nothing is shown on the site.
Settings panel: Appearance
Fields
- What it does
- The look of the input fields.
- What to enter or choose
- One of: Outline, Filled, Underline.
- Default
- Outline
- How to use it
- Click one of the buttons in the group.
- When to use it
- Outline for most sites; Filled on white backgrounds; Underline for minimal designs.
- Example
- Filled.
- Result
- All fields change style. Focus states are built in.
Full-width button
- What it does
- Stretches the submit button.
- What to enter or choose
- On or off.
- Default
- Off
- How to use it
- Click the switch to turn it on (blue) or off.
- When to use it
- Optional.
- Example
- On in narrow columns.
- Result
- The button fills the form width.
Design & styling
Select the block, open the Styles tab in the settings sidebar (the half-filled circle icon next to the gear) and use the three pickers at the top of the Style panel:
- Element — which part of the block to style.
- State — Normal, or a state such as Hover (only the states the part supports are offered).
- Device — Desktop, Tablet or Mobile, for values that can differ per screen size.
Only panels that make sense for the chosen part and state are shown. The full meaning of every control is in the Styling Controls guide; below is exactly what Form Styler offers.
Element: Fields selected first
All text fields, text areas and dropdowns. Focus state.
| Panel | Control | Per device | Available in states |
|---|---|---|---|
| Typography | Font family | — | Normal |
| Font size | Yes | Normal | |
| Weight | — | Normal | |
| Style | — | Normal | |
| Line height | Yes | Normal | |
| Letter spacing | Yes | Normal | |
| Letter case | — | Normal | |
| Alignment | Yes | Normal | |
| Decoration | — | Normal, Focus | |
| Colors | Text | — | Normal, Focus |
| Background | Type | — | Normal, Focus |
| Color / Gradient | — | Normal, Focus | |
| Image | — | Normal | |
| Border | Border type | — | Normal, Focus |
| Border | — | Normal, Focus | |
| Radius | Yes | Normal | |
| Focus indicator | — | Focus | |
| Box Shadow | Remove shadow | — | Normal, Focus |
| Shadow layers | — | Normal, Focus | |
| Spacing | Padding | Yes | Normal |
| Sizing | Width | Yes | Normal |
| Max width | Yes | Normal | |
| Height | Yes | Normal | |
| Min width / Min height / Max height | Yes | Normal | |
| Effects | Opacity (%) | Yes | Normal, Focus |
States for this part:
- Focus — When it has keyboard focus — reached with the Tab key. Mouse clicks usually do not show focus styles.
Element: Block
The form wrapper.
| Panel | Control | Per device | Available in states |
|---|---|---|---|
| Background | Type | — | Normal |
| Color / Gradient | — | Normal | |
| Image | — | Normal | |
| Border | Border type | — | Normal |
| Border | — | Normal | |
| Radius | Yes | Normal | |
| Box Shadow | Remove shadow | — | Normal |
| Shadow layers | — | Normal | |
| Spacing | Margin | Yes | Normal |
| Padding | Yes | Normal | |
| Sizing | Width | Yes | Normal |
| Max width | Yes | Normal | |
| Height | Yes | Normal | |
| Min width / Min height / Max height | Yes | Normal | |
| Block alignment | Yes | Normal | |
| Position | Position | Yes | Normal |
| Top / Right / Bottom / Left | Yes | Normal | |
| Z-index | Yes | Normal | |
| Overflow | Yes | Normal | |
| Transform | Move X / Move Y | — | Normal |
| Scale X / Scale Y | — | Normal | |
| Rotate (°), Rotate X (°), Rotate Y (°) | — | Normal | |
| Skew X (°) / Skew Y (°) | — | Normal | |
| Effects | Opacity (%) | Yes | Normal |
| State transition (ms) | — | Normal | |
| Timing | — | Normal | |
| Visibility | Show on Desktop / Tablet / Mobile | — | Normal |
States: Normal only.
Element: Labels
Field labels.
| Panel | Control | Per device | Available in states |
|---|---|---|---|
| Typography | Font family | — | Normal |
| Font size | Yes | Normal | |
| Weight | — | Normal | |
| Style | — | Normal | |
| Line height | Yes | Normal | |
| Letter spacing | Yes | Normal | |
| Letter case | — | Normal | |
| Alignment | Yes | Normal | |
| Decoration | — | Normal | |
| Colors | Text | — | Normal |
States: Normal only.
Element: Button
The submit button. Hover and Focus.
| Panel | Control | Per device | Available in states |
|---|---|---|---|
| Typography | Font family | — | Normal |
| Font size | Yes | Normal | |
| Weight | — | Normal | |
| Style | — | Normal | |
| Line height | Yes | Normal | |
| Letter spacing | Yes | Normal | |
| Letter case | — | Normal | |
| Alignment | Yes | Normal | |
| Decoration | — | Normal, Hover, Focus | |
| Colors | Text | — | Normal, Hover, Focus |
| Background | Type | — | Normal, Hover, Focus |
| Color / Gradient | — | Normal, Hover, Focus | |
| Image | — | Normal | |
| Border | Border type | — | Normal, Hover, Focus |
| Border | — | Normal, Hover, Focus | |
| Radius | Yes | Normal | |
| Focus indicator | — | Focus | |
| Box Shadow | Remove shadow | — | Normal, Hover, Focus |
| Shadow layers | — | Normal, Hover, Focus | |
| Spacing | Padding | Yes | Normal |
| Sizing | Width | Yes | Normal |
| Max width | Yes | Normal | |
| Height | Yes | Normal | |
| Min width / Min height / Max height | Yes | Normal | |
| Effects | Opacity (%) | Yes | Normal, Hover, Focus |
States for this part:
- Hover — When the mouse pointer is over it. (Touch screens have no hover; they show the normal style.)
- Focus — When it has keyboard focus — reached with the Tab key. Mouse clicks usually do not show focus styles.
Responsive settings
Brigade Blocks uses three screen sizes: Desktop (wider than 1023px), Tablet (600–1023px) and Mobile (599px and narrower). Tablet and Mobile values are optional: when empty, the value of the next larger screen is used.
In the Styles tab, pick the Device first; these controls can then have a different value for that screen size: Font size, Line height, Letter spacing, Alignment, Radius, Padding, Width, Max width, Height, Min width / Min height / Max height, Opacity (%), Margin, Block alignment, Position, Top / Right / Bottom / Left, Z-index, Overflow.
The Visibility panel (Styles tab, Normal state) can hide the block entirely on Desktop, Tablet or Mobile.
Advanced options
- HTML anchor (Advanced section of the Settings tab) — a unique name such as
pricing, so you can link straight to this block with#pricingat the end of the page address (for example from a menu). - Additional CSS class(es) (Advanced section) — for custom CSS from your theme or the Site Editor. Separate several classes with spaces.
- Custom attributes (Advanced section) — add
data-*,title,aria-label,aria-describedby,langordirattributes. See Custom attributes. - State transition (Styles tab → Effects, Normal state) — how smoothly hover and focus styles animate.
- Width alignment (block toolbar) — Wide width, Full width, when your theme supports them.
How it works on your site
Runs the plugin’s own form shortcode, so validation, emails, spam protection and add-ons keep working. The block only adds styling.
Accessibility
- Labels and error messages come from the form plugin — give every field a label there.
- Keep a visible focus style when you change field colours.
Limitations and notes
- Only Contact Form 7 and WPForms.
- Fields and messages are edited in the form plugin, not here.
- Very custom plugin layouts (multi-page WPForms, special field types) keep some of their own styling.