BYOB - Field Label Overrider (GA)

Published on February 9, 2026 BYOB

Field Label Overrider: Show the Right ID Label for Every Country

Field Label Overrider lets one field on your Contact or Account or any sobject record display a different label depending on the customer's country — for example, showing "SSN / EIN" for a U.S. contact and "VAT Number" for a contact in Europe — without creating a separate field for each country.

Behind the scenes, your data stays in one field — National_ID__c — so reporting stays simple and your record pages stay uncluttered. Only the label changes, based on the contact's Mailing Country.

Before You Begin

1. You'll need System Administrator access, or edit access to Setup, Object Manager, and Lightning App Builder.
2. The Build Your Own Branding (BYOB) package must be installed in your org.
3. Have the field you want to override ready (this guide uses National_ID__c on Contact as the example).

Step 1: Confirm BYOB Is Installed and Active

Go to Setup → Installed Packages and confirm Build Your Own Branding shows a status of Active.

The BYOB package listed as Active in Installed Packages.

Step 2: Turn On BYOB Components

Go to Setup → Custom Settings, find Byob Elements, and click Manage.

The Byob Elements custom setting in Custom Settings.

Create one new, org-wide value with these two fields set exactly as shown, then save:

1. PSC_normalViewElement: windowViewMode-normal
2. PSC_consoleViewElement: windowViewMode-maximized

Both required values entered and ready to save.

Once saved, Field Label Overrider is ready to use on any record page.

Step 3: Find Your Object and Field Names

In Object Manager, open the object you're customizing (e.g., Contact) and note its API name.

The Object Manager, used to look up object API names.

The Contact object's API Name, shown at the top of its detail page.

Then, under Fields & Relationships, find your target field and note its field API name (e.g., National_ID__c).

The field API name, found under Fields & Relationships.

Step 4: Add the Component to Your Record Page

On the record page, click the gear icon → Edit Page to open Lightning App Builder.

Opening Lightning App Builder from the record page.

Find Field Label Overrider in the Custom Managed Components panel and drag it onto the page. Place it as the last component on the page.

The Field Label Overrider component in the components panel.

The component placed as the last item on the page.

Step 5: Set the Field and Its New Label

In the component's properties, enter:

1. Field API Name: the object and field together (e.g., Contact.National_ID__c)
2. Override Field Label: the label to display (e.g., "SSN / EIN")

Field API Name and Override Field Label set for the USA scenario.

Step 6: Set When the Label Applies

Expand Set Component Visibility (a native Salesforce feature) and add a filter so this label only applies under the right condition — for example, Mailing Country equals USA. Text-based filter values are case-sensitive, so match the value exactly as it's stored on the record.

A visibility filter restricting the override to USA contacts.

Step 7: Repeat for Each Country

Add another Field Label Overrider component for each additional country — for example, a second component with label "CPF / CNPJ" and a filter for Mailing Country equals Brazil.

Multiple overrides configured for different countries on the same page.

Step 8: Test It

Save your changes, then open a few test records to confirm the label updates correctly:

USA: the label reads "SSN / EIN."

A USA contact record showing the SSN / EIN label.

Brazil: the same field now reads "CPF / CNPJ" — the underlying data hasn't changed, only the label.

A Brazil contact record showing the CPF / CNPJ label.

Any other country: the field falls back to its original label, "National ID."

The default fallback label shown when no country condition matches.

Troubleshooting

1. Label isn't changing: double-check that your filter value exactly matches the stored value's capitalization — text filters are case-sensitive.
2. Component doesn't appear in the builder: confirm the BYOB package status is Active and that the Byob Elements custom setting was saved with both values.
3. Wrong label showing: check for overlapping visibility filters between components — only one should match a given record at a time.

Knowledge Article Number: KA-00078