> For the complete documentation index, see [llms.txt](https://docs.planetstyles.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.planetstyles.net/feature-guides/group-post-highlight.md).

# Group Post Highlight

Let members of chosen groups highlight their own posts with their group's colour.

<figure><img src="https://1973628527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTA7pvCEDX33HvSpe5svL%2Fuploads%2FmekBq27wTPwMo7aGKaLb%2Fhighlighted%20post.png?alt=media&amp;token=594129dd-52ec-4e68-8b65-f8c1a78635aa" alt=""><figcaption></figcaption></figure>

Group Post Highlight lets you define reusable **highlight styles** (border, background, text colour, drop shadow and an optional badge) and assign one to a group. Members of that group can then opt in to highlighting their own posts with it, using a toggle on the reply and edit forms.

{% hint style="info" %}
Requires phpBB 3.3.x and PHP 7.1+.
{% endhint %}

### How it works

1. **Create a highlight style** in ACP under **Extensions → Group Post Highlight → Highlight Styles**: pick colours, border, shadow and an optional badge, previewed live as you build it.
2. **Assign the style to a group** in ACP under **Users & Groups → Groups**, and choose whether it's on by default for new posts.
3. **Members opt in per post** using the checkbox on the reply/edit form and quick reply. Only members whose *default* group has a style assigned see the toggle at all.

A post's appearance is never "baked in"; it's resolved live from the poster's current default group every time the post is rendered, the same way phpBB already resolves username colour. Only the opt-in choice itself is stored per post, so editing a style in ACP instantly updates every past post using it.

### In this section

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h3><i class="fa-palette" style="color:$primary;">:palette:</i></h3></td><td><strong>Creating &#x26; managing highlight styles</strong></td><td>Build a style's border, background, shadow and badge in the visual editor.</td><td></td></tr><tr><td><h3><i class="fa-users" style="color:$primary;">:users:</i></h3></td><td><strong>Assigning a style to a group</strong></td><td>Give a group its highlight style and decide whether it's on by default.</td><td></td></tr><tr><td><h3><i class="fa-toggle-on" style="color:$primary;">:toggle-on:</i></h3></td><td><strong>The member highlight toggle</strong></td><td>How the opt-in checkbox behaves on new posts, replies and edits.</td><td></td></tr><tr><td><h3><i class="fa-code" style="color:$primary;">:code:</i></h3></td><td><strong>Custom &#x26; per-theme CSS</strong></td><td>Fine-tune a style's CSS globally or for one installed frontend style only.</td><td></td></tr></tbody></table>
