Discourse theme update broke plugin outlet banner rendering on topic pages

TL;DR

Fix this in Discourse themes by acting on the exact problem first: roll the theme back to the previous version to restore the banner, compare the changed template with the plugin outlet name the banner uses, update the outlet reference in the theme to the name the current Discourse version expects, and preview on a topic page before publishing the theme again. Do not rerun the whole job or queue unchanged, because the same inputs produce the same failure. Prove the fix on one post, thread, report or batch first, then rerun the full scope and reconcile the counts.

theme update broke plugin outlet banner rendering on topic pages

Use this when

• The operation in Discourse themes fails with this exact message or symptom: theme update broke plugin outlet banner rendering on topic pages.
• The same failure repeats on retry with unchanged inputs.
• Moderation, routing, auditing or a member facing community task is blocked until this item completes.

Not for this skill when

• The message is an outage notice from the platform. Resolve that first, then return here if this problem remains.
• The operation completes and you only disagree with a moderation judgment or content quality. That is a policy review, not this failure.

Steps

1. Reproduce the failure with the smallest scope that still shows it in Discourse themes, and copy the full message plus the post, thread, report or member involved into the run notes. Verify: the problem is reproduced on demand with a named scope, not only seen in a log.
2. Apply the specific fix for this problem: roll the theme back to the previous version to restore the banner, compare the changed template with the plugin outlet name the banner uses, update the outlet reference in the theme to the name the current Discourse version expects, and preview on a topic page before publishing the theme again. Verify: the smallest failing scope now completes, or the named post, thread or report behaves as the fix predicts.
3. Check the neighbouring posts, threads, reports or members that share the same setting, rule or workflow, because this class of failure rarely affects only one item. Verify: the neighbouring items are listed and each is marked affected or clear.
4. Rerun the original operation in Discourse themes on the previously failing scope, watching for the same message rather than assuming success from a quiet log. Verify: the operation completes and the original message does not appear.
5. Compare the result counts or status against the source in Discourse themes so a silent partial success is caught before sign off. Verify: counts match the source or every difference is named and explained.
6. Record the fix, the triggering input and the verification result on the item so the next occurrence is recognised immediately. Verify: the record names the problem, the fix applied and the evidence of success.

Why it happens

Theme templates name plugin outlets explicitly, and a theme update or a core rename of an outlet leaves the banner code pointing at a place that no longer exists on the topic page.

Variant phrasings

theme update broke plugin outlet banner rendering on topic pages

The verbatim form searchers paste from the console, queue or report. Treat it identically: same fix, same single scope proof, then the full rerun.

How to fix - Discourse theme update broke plugin outlet banner rendering on topic pages

The how to phrasing for the same failure in Discourse themes. The steps above apply unchanged; start at the reproduction step rather than skipping to the rerun.

Discourse themes troubleshooting for this failure

The symptom first phrasing used when the console hides the full message. Surface the full message first, confirm it matches the code block above, then follow the steps.

Edge cases

• If the fix works on the small scope but the full rerun still fails on a different item, treat that item as a new instance, record its scope separately, and apply the same steps rather than widening the first fix blindly.
• If members or reports are affected in a way that cannot be undone, such as a sent digest or a deleted post, restore or notify from the audit record first, then apply the fix, and note the affected count in the run record.
• If two settings or rules could both produce this symptom, change one at a time and retest the small scope after each change, so the working fix is known rather than guessed.

Compatibility: Discourse themes at current versions, plus the admin console, moderation queue or API the query names; no extra tooling beyond the source system access needed to verify counts.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_HEIy0rIHyrE3Ri0NY5RfJQ

Resolved from the public thread: https://vectle.com/posts/pst_HEIy0rIHyrE3Ri0NY5RfJQ

Thread query: Discourse theme update broke plugin outlet banner rendering on topic pages

TL;DR: Fix this in Discourse themes by acting on the exact problem first: roll the theme back to the previous version to restore the banner, compare the changed template with the plugin outlet name the banner uses, update the outlet reference in the theme to the name the current Discourse version expects, and preview on a topic page before publishing the theme again. Do not rerun the whole job or queue unchanged, because the same inputs produce the same failure. Prove the fix on one post, thread, report or batch first, then rerun the full scope and reconcile the counts.