# PL: Pro labels

Track PL (owner decision, 2026-11-14). Pro appears only as a label and never in a description. There is one "Pro" badge everywhere, shown only to free users and linking to the pricing page. Locked Pro pages keep one upgrade panel, in translatable text.

## Audit (PL-1)

### Pro in setting descriptions

These are the six section descriptions in `app/Admin/config/chatbot.php` that end in "PRO feature.". No other setting description, label or title in `app/Admin/config/` or `premium/app/Admin/config/` names Pro or Premium.

| Section          | Line (development, 2026-11-14) |
| ---------------- | ------------------------------ |
| `vectorDb`       | 841                            |
| `curation`       | 845                            |
| `observability`  | 867                            |
| `handoff`        | 871                            |
| `customerCentre` | 881                            |
| `evaluation`     | 890                            |

**Change:** the text goes, and the section gets `onlyPremium` (PL-3).

### Badges

| Where                                | Today                                                    | Change (PL-2)                                                                                     |
| ------------------------------------ | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| Menu item (`Menu.jsx`)               | `ProOnlyBadge` inline: "Pro Only", filled chip           | `ProBadge`: "Pro", not a link (the menu item is a link)                                           |
| Page header (`Header.jsx`)           | `ProOnlyBadge` pill: "Premium Only" with a crown, linked | `ProBadge`: "Pro", linked                                                                         |
| Field (`FieldDescription.jsx`)       | pill, only when the field has a description              | `ProBadge`, also without a description, and not on fields of a section that has the badge already |
| Section (`FieldGrid.jsx`)            | none: sections cannot carry `onlyPremium`                | `ProBadge` next to the section title                                                              |
| Upgrade card (`UpgradeToPro.jsx`)    | pill                                                     | `ProBadge`                                                                                        |
| Sidebar footer (`PluginVersion.jsx`) | "Free" or "Premium"                                      | unchanged: it names the installed plan, not a feature                                             |

`ProBadge` renders only for free users (`kimaaiAdmin.isPremium` false). It shows the same word in every place, and its tooltip says the feature is in KimaAI Pro.

### Upgrade panels

| Where                                                                                          | Today                                                                                          | Change (PL-4)                                                                               |
| ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| Locked settings pages (`PremiumLock.jsx`, `PremiumUpgrade`, also used by `RepeatablePage.jsx`) | Hard-coded English                                                                             | Translatable                                                                                |
| Embedding panels (`Embedding/Section.jsx`: Query, Collections, Health)                         | Hard-coded English line linking to `kimaai.com/price`                                          | The same `UpgradeToPro` panel in its compact form, linking to the pricing page in the admin |
| Insights tabs (Topics, Content gaps, Conversions) and Feedback                                 | `UpgradeToPro` with translated text; each passes its own "Upgrade to Pro" button text and link | Unchanged content; the button text and link become the panel's defaults                     |

### Not changed

The admin assistant's message "%s is a Pro feature. Upgrade to Pro to use this guided workflow." (`AdminAssistantWorkflowManager.php`) is a reply to a free user who asks for a Pro workflow, not a setting description. It stays.

## Tests (PL-5)

- A unit test fails when a description in the settings config names Pro or Premium as a feature tier.
- Jest covers the badge: free and Pro users, menu without a link, sections, and fields without a description.
- Jest also covers the compact upgrade panel.
