# BW Dev — Known Issues

**Last Updated:** 2026-05-11

Track active bugs, limitations, and workarounds here. Resolved issues should be moved to the CHANGELOG under the version that fixed them.

## Active

### Post Link Block module — content + CSS rename on migration
**Severity:** Migration-only.
**Affects:** Sites with saved posts containing the old `wp:bw/pretty-post-link-list` / `wp:bw/pretty-post-link-item` block markup, or custom CSS targeting `.bw-ppl*` classes.
**Details:** Block names changed `bw/pretty-post-link-list` → `bw-dev/post-link-list` and `bw/pretty-post-link-item` → `bw-dev/post-link-item`. REST namespace changed `bw-ppl/v1` → `bw-dev/v1`. CSS prefix changed `.bw-ppl*` → `.bw-dev-post-link*`. CSS variable changed `--bw-ppl-img-width` → `--bw-dev-post-link-img-width`.
**Workaround:** Bulk find/replace in post content for the block name (`wp:bw/pretty-post-link-` → `wp:bw-dev/post-link-`). Update custom CSS to the new class prefix. No site-side data migration since the block has no persisted module settings.
**Resolution:** Could automate via WP-CLI search-replace; not built into Phase 8 migration because content rewriting is destructive and best done deliberately by the site owner.

### Admin Columns module — column IDs and CSS class rename
**Severity:** Migration-only.
**Affects:** Sites with custom CSS targeting `.bw-featured-image-cell`, `.bw-admin-thumb`, `.bw-admin-column-*`, etc., or custom code referencing column IDs `bw_featured_image`, `bw_tax_*`, `bw_meta_*`.
**Details:** Column IDs renamed `bw_featured_image` → `bw_dev_featured_image`, `bw_tax_*` → `bw_dev_tax_*`, `bw_meta_*` → `bw_dev_meta_*`. CSS classes renamed `bw-admin-column-*` → `bw-dev-admin-columns-*`, `bw-featured-image-cell` → `bw-dev-admin-columns-featured-image-cell`, `bw-admin-thumb` → `bw-dev-admin-columns-thumb`. AJAX action names re-prefixed.
**Workaround:** Settings (the per-post-type config) migrate automatically. Update any custom CSS / code targeting the old class names or column IDs.
**Resolution:** No code fix planned.

### YouTube module — CSS class rename + block name change breaks content/CSS
**Severity:** Migration-only.
**Affects:** Sites switching from `bw-youtube-embed` → bw-dev's YouTube module that wrote custom CSS against the old class names, or have post content with the old block name in saved HTML.
**Details:** Block name changed `bw/youtube` → `bw-dev/youtube`. CSS classes renamed `.bw-youtube-block` → `.bw-dev-youtube-block`, `.bw-youtube-block__inner` → `.bw-dev-youtube-block__inner`, `.bw-youtube-block--fallback-image` → `.bw-dev-youtube-block--fallback-image`, `.bw-youtube-block__featured-img` → `.bw-dev-youtube-block__featured-img`. The `[bw_youtube]` shortcode keeps working — bw-dev registers it as an alias when the legacy plugin is inactive.
**Workaround:** Posts using the old `<!-- wp:bw/youtube -->` block will need a one-time content update on migration (find/replace `wp:bw/youtube` → `wp:bw-dev/youtube`). Custom CSS targeting the old classes needs updating. The shortcode is handled automatically.
**Resolution:** Phase 8 migration could add a content rewrite step. Track as Phase 8 item.

### Sticky module — CSS class rename breaks site overrides
**Severity:** Migration-only. Doesn't affect new installs.
**Affects:** Sites switching from `bw-sticky-settings` → bw-dev's Sticky module that wrote custom CSS against the old class names.
**Details:** The original plugin's frontend script added `.bw-is-sticky` and `.bw-is-pushed` to the user's element while sticky. The bw-dev port renames these to `.bw-dev-is-sticky` and `.bw-dev-is-pushed` (and the placeholder div from `.bw-sticky-placeholder` → `.bw-dev-sticky-placeholder`). The global JS config object also changed: `window.bwStickyConfig` → `window.bwDevStickyConfig`.
**Workaround:** Update any site CSS / custom JS that referenced the old class names. Migration won't catch this automatically — it only moves the option value.
**Resolution:** Document during Phase 8 migration steps. No code fix planned.

## Resolved

(see CHANGELOG.md)