Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full Screen Pop entry
How-to guide

Configure screen pops with a softphone layout

Here is how to set up screen pops with a softphone layout for an Open CTI or partner phone adapter. The layout decides what records pop for inbound calls, and you assign it to the profiles that should use it.

By Dipojjal Chakrabarti · Founder & Editor, Salesforce DictionaryLast updated Jun 16, 2026

Here is how to set up screen pops with a softphone layout for an Open CTI or partner phone adapter. The layout decides what records pop for inbound calls, and you assign it to the profiles that should use it.

  1. Create or edit a softphone layout

    In Setup, search for Softphone Layouts. Create a new layout or edit an existing one, and give it a clear name like Support Inbound. This is the object that holds your screen pop rules.

  2. Pick the call type and objects to search

    Choose the Inbound section, since that is where screen pops apply to incoming calls. Add the objects you want searched by caller number, such as Contact, Lead, and Account, and select the fields to display in the softphone.

  3. Set the screen pop rules per outcome

    Define what happens for a single match, multiple matches, and no match. A typical setup pops the matched record on a single match, a search page on multiple matches, and a new-record or object-home page when nothing matches.

  4. Assign the layout to profiles

    Use the Softphone Layout Assignment to map this layout to the user profiles that should use it. Save, then test with a real inbound call to confirm the right record pops before rolling it out.

Key options
Single match actionremember

What pops when one record matches the call. Usually set to pop the matched record directly so the agent sees the customer.

Multiple matches actionremember

What pops when several records share the number. Commonly a search results page so the agent chooses the correct record.

No match actionremember

What happens when nothing matches. Options include doing nothing, popping an object home page, or popping a pre-filled new-record screen.

Screen pops open withinremember

Controls whether pops open in the existing window or a new one. Lightning Experience always uses the existing window regardless of this setting.

Call-related fieldsremember

The call data shown in the softphone, such as ANI, DNIS, SEGMENT, and QUEUE, which can also feed the search behind the pop.

Gotchas
  • Lightning Experience ignores the New browser window or tab option for screen pops and always opens them in the existing window.
  • Softphone layouts are assigned by profile, so a user with no assigned layout gets the default one, which may not pop what you expect.
  • A pop only works if the caller number actually matches a stored record, so phone-number data hygiene directly affects single-match rates.
  • For Service Cloud Voice, prefer the Add Screen Pop action in an Omni-Channel flow over a static layout when you need branching logic.

See the full Screen Pop entry

Screen Pop includes the definition, worked example, deep dive, related terms, and a quiz.