Skip to content

Refactor widgets documentation and update advanced settings image #405

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Dannyholt merged 2 commits into from
Jun 13, 2026
Merged

Refactor widgets documentation and update advanced settings image #405

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ac5cf72
Refactor widgets documentation and update advanced settings image
Dannyholt Jun 13, 2026
89ee046
Merge branch 'master' into bens-fixes
Dannyholt Jun 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 7 additions & 38 deletions beaver-builder/layouts/modules/widgets.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Use WordPress widgets inside Beaver Builder layouts for plugin-specific features

:::warning

On newer installations, the WordPress Widgets module is disabled by default. You can enable it at any time in [Beaver Builder module settings](MISSINGLINK).
On newer installations, the WordPress Widgets module is disabled by default. You can enable it at any time in [Beaver Builder module settings](../../settings/modules.md).
:::

## Usage
Expand All @@ -20,38 +20,15 @@ Any registered WordPress widget is automatically available as a module in the Be

## Access Widgets

:::note
1. Launch Beaver Builder on your page or post.
2. Click the + button in the top-right corner to open the Content Panel.
3. Select the Modules tab (if not already selected), then scroll down to the WordPress Widgets subgroup.
4.Drag the desired widget module into your layout and configure its settings in the panel that appears.

WordPress replaced traditional widgets with blocks starting in WordPress 5.8. For the best experience, use native Beaver Builder modules or third-party modules instead of legacy widgets.
:::info
WordPress replaced traditional widgets with blocks starting in WordPress 5.8. For the best experience, use native Beaver Builder modules or third-party modules instead of legacy widgets.
:::


<details>
<summary><strong>Launch Builder</strong></summary>


Launch Beaver Builder on your page or post.
</details>
<details>
<summary><strong>Open the Content Panel</strong></summary>


Click the + button in the top-right corner to open the Content Panel.
</details>
<details>
<summary><strong>Go to the Modules tab</strong></summary>


Select the Modules tab (if not already selected), then scroll down to the WordPress Widgets subgroup.
</details>
<details>
<summary><strong>Drag and drop</strong></summary>


Drag the desired widget module into your layout and configure its settings in the panel that appears.
</details>


## Widget Module Settings

Each Widget module includes a General settings tab, along with the standard Advanced tab.
Expand Down Expand Up @@ -104,14 +81,6 @@ The following widget classes are excluded by default:

</details>

<details>
<summary><strong>WPML-specific exclusion</strong></summary>


When WPML is active, Beaver Builder also excludes the WPML language switcher because it must run inside a registered sidebar.
</details>


## Third-party widget compatibility

Third-party widgets are built primarily for the WordPress admin widget screen and may not fully initialize in front-end builder rendering. The most common issue is scripts or styles that only load in admin contexts.
Expand Down
Binary file added static/img/beaver-builder/2.10--settings--advanced.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion versioned_docs/version-2.10/settings/advanced.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ The Advanced tab within Beaver Builder's settings provides options to enable or
2. Navigate to **Settings > Beaver Builder**.
3. Then click the **Advanced** tab.

![Beaver Builder Advanced settings](/img/beaver-builder/settings--advanced--1.jpg)
![Beaver Builder Advanced settings](/img/beaver-builder/2.10--settings--advanced.jpg)

## Builder UI

Expand Down
Loading