Skip to content

Clarify widget management UX: Appearance > Widgets vs Customize > Widgets (customer confusion) #102

Description

@tg-autopilot

Summary

Customer reports confusion about widget management: Spacious widgets can be edited from both the standard WordPress Appearance > Widgets screen and from Appearance > Customize > Widgets. The overlap can be confusing when older widgets from a previous theme remain in widget areas and new blocks are added through the Customizer. The customer suggests clarifying the widget management experience in the theme to avoid this confusion.

Customer context

Transcript from Crisp support conversation session_9753cb4d-836d-4a20-94e9-37644f7bf349. No WordPress or theme version provided by the customer.

Reproduction notes

  1. Install Spacious as the active theme on a WordPress site that has previously used another theme with widgets (so old widgets may be assigned to registered sidebars).
  2. Open Appearance > Widgets. Observe existing widgets in registered widget areas.
  3. Open Appearance > Customize > Widgets (Customizer). Note the same widget areas and the ability to add/remove widgets from the Customizer UI.
  4. Add new widget blocks via the Customizer, and the change will also be reflected in the Appearance > Widgets screen (and vice versa).

Reproduced by code inspection of theme's widget registration and customizer files; no runtime repro was performed in a live WP instance for this triage.

Diagnosis

This is primarily a user experience / product request rather than a code bug. The behavior reported is consistent with how WordPress core exposes widget management in two interfaces:

  • Theme registers widget areas in: inc/widgets/widgets.php (examples below)

    • file:inc/widgets/widgets.php:16-25 (Right Sidebar registration)
    • file:inc/widgets/widgets.php:28-36 (Left Sidebar registration)
    • file:inc/widgets/widgets.php:116-125 (Footer Sidebar One registration)
  • Customizer integration is handled by the theme's customizer code which loads customizer panels and options:

    • file:inc/customizer/class-spacious-customizer.php:36 (adds customize_register action)
    • file:inc/customizer/class-spacious-customizer.php:386-426 (includes footer and WooCommerce customize options)

Because WordPress core provides both the
Widget screens (Appearance > Widgets) and the Customizer (Appearance > Customize > Widgets), the theme cannot fully remove that overlap without relying on WordPress core changes. Possible theme-side improvements include:

  • Add a short explanatory note in the Customizer widget sections (or the theme's Customizer panels) explaining that widgets can also be managed via Appearance > Widgets and advising users to remove unused widgets after switching themes.
  • Provide documentation or a migration helper that detects widgets assigned to sidebars that no longer match (or were left over after a theme change) and offers a guided cleanup.

Confidence: 85/100

Source: Crisp conversation

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bug-report-triageAI-triaged (see issue body for confidence/provenance)feature-requestFeature request surfaced by AI triage

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions