Customizing the lead profile page

Modified on Wed, 6 May at 7:18 AM

Customizing the lead profile page

The lead profile page is the central workspace for viewing and managing individual leads. Configure which information boxes are shown, the page layout, custom content integrations, and multi-user locking.

TL;DR

Access: Campaign settings → Profile page. Configure: Profile title/subtitle using placeholders + @if/@else. Choose boxes to show (Field values, Title box, History, Comments, Calendar, Files, Relations, etc.) with column width (Wide/Medium/Narrow) and collapsed state. Add custom content boxes (HTML, maps, external embeds) using Hubhus placeholders. Enable lead locking for teams with multiple simultaneous users.

4 things to configure

1

Profile title, subtitle, and icon

Go to Campaign settings → Profile page → Profile section. Set the title using placeholders, e.g. @if(%lead_name%){%lead_name%}@else{%lead_company%}@endif. Add a subtitle for secondary info. Configure an optional image URL (logo field, auto-size) or Font Awesome icon class (e.g. fa fa-user, size ~38px). Always include fallback logic in title — missing field = blank title.

2

Information boxes

Under Profile page → Information shown: choose which boxes are visible and their layout. For each box set: Shown on page, Collapsed (default collapsed state), Column (Wide/Medium/Narrow). Essential boxes: Field values (Wide), Title box (fixed upper right). Commonly shown: Calendar (Medium, collapsed), Comments (Medium, collapsed). Optional: History, Files, Relations, Previews of files, External email history. Set column order (e.g. Wide | Medium | Narrow) and "Hide fields with empty values" for a cleaner view.

3

Custom content boxes

Click + New content box. Set: friendly name (e.g. "Google Street View"), preferred width, body type (HTML/Raw), HTML content with Hubhus placeholders, optional CSS/JS. Example for Google Street View: <hh-gmap.street-view location="%lead_full_address%" style="min-height:500px;" />. Use Ctrl+K / Cmd+K in the editor to search placeholders. Keep custom boxes lightweight — heavy embeds slow page load.

4

Lead locking

Check Use locking: Leads can be viewed by only one user at a time to prevent conflicting edits when multiple users work the same campaign simultaneously. Set auto-unlock timeout (default: 1 hour) — prevents leads from staying locked if a user forgets to close the page. Locking only applies to logged-in users.

Read more

Profile title patterns

Use these patterns in Campaign settings → Profile page → Profile section → Title:

Simple name display:
%lead_name%

Name with company fallback:
@if(%lead_name%){%lead_name%}@else{%lead_company%}@endif

Name and company combined:
%lead_name% - %lead_company%

With custom field:
{{custom-field-slug}}

Browse all icons at Font Awesome 4.7 cheatsheet. Common: fa fa-user, fa fa-building, fa fa-map-marker, fa fa-envelope. Set icon size to ~38px.

Troubleshooting

Profile title shows blank or incorrect data

  • Check placeholder syntax is correct — e.g. %lead_name% not lead_name
  • Verify the field contains data for the lead you are testing
  • Ensure your at-if/at-else logic includes proper fallbacks to avoid blank output
  • Test with multiple leads to check whether it is a data issue or a syntax issue

Box not appearing on profile page

  • Verify "Shown on page" is checked for that box
  • Some boxes only display when they contain data — e.g. Calendar shows nothing if the lead has no events
  • Refresh the page after saving settings
  • Check for JavaScript errors in the browser console

Custom content box not loading or showing errors

  • Check that "Shown" is enabled for the custom box
  • Verify HTML is valid — unclosed tags can break rendering
  • Test placeholders individually — an invalid placeholder may prevent the whole box from rendering
  • Temporarily remove custom CSS and JS to isolate the problem
  • Check browser console for specific error messages

Lead is stuck locked / locking not working

  • Confirm "Use locking" is checked and settings are saved
  • Locking only applies to logged-in users — anonymous access is not affected
  • If a lead is stuck locked, wait for the auto-unlock timeout or ask the locking user to close the tab
  • Contact support if leads remain locked beyond the configured timeout

Profile page loads slowly

  • Hide unused boxes — each visible box adds a data query
  • Collapse heavy boxes by default (History, Files)
  • Optimize custom content — remove heavy images, complex scripts, or external API calls that may timeout
  • Consider hiding "Previews of files" for leads with many file attachments

Common searches

profile page • lead detail page • lead page layout • custom content box • lead locking • profile title • boxes to show • column layout

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article