You are here:
Add a Create Referral Button to a Case or Referral Page
Let caseworkers create an outbound referral from a case or an inbound referral by opening the provider referral guided flow on a record page.
Required Editions
| View supported product editions. |
| User Permissions Needed | |
|---|---|
| To create custom buttons or links: | Customize Application |
| To access Create Outbound Referral Omniscript: | OmniStudio Admin AND Provider Management Access permission sets |
| To access cases: | Public Sector Access permission set |
| To access referrals: | Case Referral permission set |
- From the App Launcher, find and select Omniscripts.
- Expand Referral/OutboundReferral and click Create Outbound Referral (Version 1).
-
Click
and select How To Launch.
-
Find and copy the Lightning URL.
You apply the URL when you configure the button.
- From Setup, in Object Manager, select Case or Referral.
- Click Button, Links, and Actions, and then click New Button or Link.
-
Configure the button.
- Enter a label for the button, for example, Create Referral. Then press Tab to populate the API name.
- For Display Type, select Detail Page Button.
- For Behavior, select Display in existing window with sidebar.
- For Content Source, select URL.
-
In the Custom Button or Link Editor text box, for Case, enter the URL that you copied in
this format: [Lightning-URL]&c__ContextId={!Case.Id}. For
Referral, enter the URL that you copied in this format:
[Lightning-URL]&c__ContextId={!Referral.Id}
To change the title of the tab that the flow opens in, change the value of
omniscript__tabLabelin the URL. For example, to set the tab title to Create Referral: omniscript__tabLabel=Create%20ReferralTo change the tab icon, for Case, add the
omniscript__tabIconparameter to the URL with value that you want: [Lightning-URL]&omniscript__tabIcon=standard:product_transfer_state&c__ContextId={!Case.Id}. For Referral, add the parameter in this format: [Lightning-URL]&omniscript__tabIcon=standard:product_transfer_state&c__ContextId={!Referral.Id}
-
Save your changes.
You can now add the button to the page layout.
- On the Object Manager page for Case, select Case Page Layouts. Or on the Object Manager page for Referral, select Page Layouts
-
For the page that you want to add the button to, click
and select
Edit.
- Click Buttons.
- For a Case page, drag the Create Referral button to the Custom Buttons list under Case Detail. For a Referral page, drag the Create Referral button to the Custom Buttons list under Referral Detail.
- Save your changes.

