--- schema_version: "1" id: f50e528cc4da85003d4422aa4fed930fda207156a86c22b402c13459fb9f5f3f title: Considerations for Creating In-App Guidance collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/sales/264-0-0/customhelp_lex_prompt_consider.md canonical_url: https://help.salesforce.com/s/articleView?id=sales.customhelp_lex_prompt_consider.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: c89bd379bb526ce91ee4a5f390db57ab295e9cc32408efe4085126b45d44685c description: Before creating prompts and walkthroughs, review the options available in the In-App Guidance Builder and In-App Guidance Settings window that determine the behavior of the prompts and walkthroughs you create. products: - Sales - Sales Enablement release: "264" --- # Considerations for Creating In-App Guidance Before creating prompts and walkthroughs, review the options available in the In-App Guidance Builder and In-App Guidance Settings window that determine the behavior of the prompts and walkthroughs you create. ### Required Editions

Available in: Lightning Experience

Available with a limited number of active walkthroughs in: Essentials, Group, Professional, Enterprise, Performance, Unlimited, and Developer Editions

Available with Enablement, which is available in Developer Edition with a limited number of add-ons and with Sales, Service, or Salesforce Platform in: Enterprise, Performance, Unlimited and Einstein 1 Sales EditionEditions for an additional cost

In-app guidance in Experience Cloud sites with Partner Enablement requires an Enablement add-on license and supported PRM add-on license.

## Environment If your company has purchased Enablement, purchased Enablement Partner Relationship Management (PRM), and has created an Experience Cloud site built with Aura templates, an Environment dropdown is available in the In-App Guidance Builder header. Specify whether you’re creating in-app guidance for Lightning Experience or a supported Experience Cloud site. To see sites in the Environment dropdown, make sure you have the appropriate permission or access. See [Permissions for Creating and Accessing In-App Guidance](https://help.salesforce.com/s/articleView?id=sales.customhelp_lex_wt_license.htm&release=264.0.0&type=5 "A Salesforce admin assigns permissions to users who create in-app guidance in any environment, who access walkthroughs in Lightning Experience, and who access in-app guidance in Experience Cloud sites. No permissions are necessary for accessing prompts in Lightning Experience."). ## Prompt Location in Lightning Experience To ensure that a prompt reaches your users where they need it, select the best combination of page and app from the Prompt Location dropdown. For some location options, go to the page or app, from within In-App Guidance Builder, where you want to create the prompt. These options are available for a prompt in Lightning Experience. | Option | Description | | --- | --- | | This Page, This App | The prompt appears on the app and page that you’re viewing when you click **Add**. | | This Page, Any App | The prompt appears for the page that you’re viewing when you click **Add**, but the page appears to users in any app that contains the page. | | Any Page, Any App | The prompt appears anywhere in Lightning Experience. A user sees the prompt when they first log in. | | Any Page, This App | The prompt appears on any page in the app that you’re viewing when you click **Add**. | In Lightning Experience, you can add prompts on these pages. - Object record pages - Object home pages - New, Edit, and Clone record pages, including windows For record pages, you can add a prompt to a record page type, but not a specific record. The prompt takes users to record they can access. If a new or cloned record page has multiple record types, you can specify whether the prompt appears for all record types or a specific record type. If you try to add a prompt to a Task record page that uses split view, the prompt appears on the Task home page instead. You can’t select global action windows for creating targeted prompts. The targeted prompts that are created on global action windows appear as floating prompts when users view an in-app guidance. ## Prompt Location in Experience Cloud Sites These options are available for a prompt in an Experience Cloud site. | Option | Description | | --- | --- | | This Page | The prompt appears on the site page you’re viewing when you click **Add**. | | Any Page | The prompt appears on any site page. | Prompts are compatible with most record type pages, except Account. ## Custom Theme Color For prompts in Lightning Experience, you can customize the color theme to align with your Salesforce org or app’s colors. Select from up to four suggested colors, based on the Themes and Branding or Lightning App Builder settings. - Brand color - Page Background color - Global Header Background color - App brand color (if the app has a custom theme) The color you select is adjusted for accessibility, if necessary. To ensure that the prompt’s text remains visible with the selected color, preview the prompt. There are a few other considerations about how theme color is applied. - In a walkthrough, the color you select for the first step applies to all steps. - The custom theme color applies only to the custom in-app guidance you create, not to content that Salesforce provides. - Microsoft® Internet Explorer® 11 doesn’t support a custom theme color. For prompts in Experience Cloud sites, In-App Guidance Builder doesn’t provide an option for selecting a custom theme color. Instead, prompts inherit your site brand colors. ## Images Upload or add a URL to a .jpg, .jpeg, .png, or .gif file, including animated .gif files. Animated .png files aren’t supported. ![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sales-iag-264-0-0-production-enus/a45c480e-33d8-4e53-927a-228fcd4ff716/images/icon_important.png) Important When you localize a prompt, Translation Workbench supports only images added by URL. See [Considerations for Localizing In-App Guidance](https://help.salesforce.com/s/articleView?id=sales.iag_localize.htm&release=264.0.0&type=5 "In Translation Workbench, you can localize prompts and walkthroughs for international users, but some considerations apply."). Keep these tips in mind when adding images to in-app guidance.

Type	Supported Image Positions, Relative to the Prompt Text
Type	Above	Below	Left	Right
Floating prompt
Targeted prompt
Docked prompt

- For images above or below text, the maximum size is 324 px × 132 px. For images to the right or left of the text, the maximum size is 148 px × 148 px. - Images are resized to fit and maintain their aspect ratio. - The maximum file size is 5 MB. - To represent the image to visually impaired or low-vision users, include alt text. ![Tip](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sales-iag-264-0-0-production-enus/a45c480e-33d8-4e53-927a-228fcd4ff716/images/icon_tip.png) Tip To ensure that linked images appear correctly, use trusted URLs. Add the Trusted URL in Setup, and select the **connect-src (scripts)** and **img-src (images)** Content Security Policy (CSP) directives. Allow cross-origin content on your host server as needed by providing the [Access-Control-Allow-Origin](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin) response header with the image. For more information, see [Manage Trusted URLs](https://help.salesforce.com/articleView?id=security_trusted_urls_manage.htm&language=en_US) in Salesforce Help. ## Video In a docked prompt in Lightning Experience, you can explain more complex ideas with an embedded video. Users can watch the video within the docked prompt, in the expanded docked prompt, or in full screen. ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sales-iag-264-0-0-production-enus/a45c480e-33d8-4e53-927a-228fcd4ff716/images/icon_note.png) Note You can include an image or an embedded video. If you first include an embedded video and then include an image, the image replaces the video in the docked prompt. If a video doesn’t load, check your browser privacy settings. For example, YouTube provides the Privacy-Enhanced Mode. To add a video, find the video’s embed code, which varies depending on the video host. For example, here’s what the embed code looks like for a YouTube video. ```html ``` Copy the URL from the embed code’s src attribute and enter the URL for the docked prompt’s Video Embed URL. In this example, enter https://www.youtube.com/embed/di6iwHhrH6. ![Tip](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sales-iag-264-0-0-production-enus/a45c480e-33d8-4e53-927a-228fcd4ff716/images/icon_tip.png) Tip To ensure that videos embed properly, use trusted sites. YouTube, Vidyard, and Vimeo are trusted websites for In-App Guidance. If videos from other sites don’t appear correctly, try adding those sites as trusted URLs. For more information, see [Manage Trusted URLs](https://help.salesforce.com/articleView?id=security_trusted_urls_manage.htm&language=en_US) in Salesforce Help. The video player actions vary depending on the video host. ## Action Button and Link After you create and save a type of in-app guidance, the In-App Guidance Settings window appears and provides an option to add an Action button or link. In a walkthrough, the action link is available only in the final prompt. Enter a relative URL or a fully qualified URL with an http:// or https:// prefix. Usually, clicking the Action button or link opens a new tab. If you add a URL for a flow in Lightning Experience, clicking the Action button or link refreshes the current tab. ## Schedule In the In-App Guidance Settings window, the Schedule step includes options for specifying when and how frequently the in-app guidance is available. Use the Date Range options to specify the start and end date you want the in-app guidance to be visible. To ensure that users understand or take a desired action on the content, show the same prompt or walkthrough multiple times. Specify the number of times to show the in-app guidance and the days in between occurrences. You can show the same in-app guidance up to 30 times, with up to 30 days in between. Consider the date range when deciding how many days between each repeat. By default, a 24-hour delay applies to all prompts and walkthroughs, including in-app guidance that Salesforce provides, so that a user sees only one prompt or walkthrough per day per app. In Lightning Experience, if a prompt’s location is set to one of the Any App options, then it counts for the user’s delay for that app. You can change the default time delay for all in-app guidance from the Settings window on the In-App Guidance Setup page. See [Change the Default Time Delay for Showing In-App Guidance](https://help.salesforce.com/s/articleView?id=sales.iag_delay.htm&release=264.0.0&type=5 "By default, a 24-hour delay applies to all prompts and walkthroughs, including in-app guidance that Salesforce provides, so that a user sees only one prompt or walkthrough per day per app. To change the default time delay for showing a prompt or walkthrough again after a user dismissed it, specify a custom value from the In-App Guidance page in Setup."). Or, choose to ignore the delay for a single prompt or walkthrough by selecting **Show when the page loads** in the Schedule step of the In-App Guidance Settings window. The specified Schedule still applies, including the start date, times to show, and days in between. A single prompt or walkthrough appears no more than one time every 24 hours, even when you adjust the global time delay or show the in-app guidance when the page loads. Depending on how users interact with a specific prompt or walkthrough, the prompt or walkthrough continues to appear or stay hidden.

User Interaction	Floating and Targeted Prompts	Docked Prompt	Walkthrough
The user didn’t acknowledge or interact with the prompt.	Show the prompt again.	Show the prompt again.	Show the walkthrough again.
The user clicked the X to close the prompt.	Not applicable. This type of prompt doesn’t have an X.	If there’s no Action button on the prompt, stop showing the prompt. If there’s an Action button on the prompt, show the prompt again.	Show the walkthrough again.
The user snoozed the prompt.	Show the prompt again the next time the user navigates to the page, after the snooze time expires.	Show the prompt again the next time the user navigates to the page, after the snooze time expires.	Show the walkthrough again the next time the user navigates to the page, after the snooze time expires.
The user clicked the Dismiss button.	If there’s only a Dismiss button, stop showing the prompt even if there are more scheduled occurrences. If there’s a Dismiss button and an Action button, show the prompt again.	Not applicable. This type of prompt doesn’t have a Dismiss button.	Show the walkthrough again.
The user clicked the Action button (prompt) or action link (walkthrough).	Stop showing the prompt even if there are more scheduled occurrences.	Stop showing the prompt even if there are more scheduled occurrences.	Stop showing the walkthrough even if there are more scheduled occurrences.
The user clicked the finish button.	Not applicable for prompts.	Not applicable for prompts.	Stop showing the walkthrough even if there are more scheduled occurrences.

Watching a video doesn’t register as a user interaction. ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sales-iag-264-0-0-production-enus/a45c480e-33d8-4e53-927a-228fcd4ff716/images/icon_note.png) Note Turning off **Custom In-App Guidance** from the Settings window on the In-App Guidance Setup page prevents your prompts or walkthroughs from appearing as scheduled. But users can still access prompts or walkthroughs directly by following a URL that you share with them. ## Profile and Permission Restrictions You can specify whether a prompt or walkthrough is visible for everyone in the environment or only a specific group of users. In the In-App Guidance Settings window, the Profiles and Permissions steps include options for specifying restrictions. By default, in-app guidance has no restrictions, but you can select standard and custom profiles and permissions that you want to apply. Applied profiles and permissions work a bit differently. - If you apply multiple profiles, the in-app guidance is visible to a user who has any of the specified profiles. - If you apply multiple permissions, the in-app guidance is visible to a user who has all the specified permissions. - If you apply multiple profiles and multiple permissions, the in-app guidance is visible to a user who has any of the specified profiles and all of the specified permissions. You can select up to 10 combined profiles and permissions for each prompt or walkthrough. ## Shareable URL Create a link to a prompt or walkthrough that you can share. In the In-App Guidance Settings window, the Details step includes an option to copy the URL. For prompts or walkthroughs in Lightning Experience, you can also select **Copy URL** from the actions dropdown on the In-App Guidance page in Setup. Connect multiple walkthroughs together by using one walkthrough’s URL as the destination for another walkthrough’s action link. If you use the URL as the Action button or link, the prompt opens in a new tab and the walkthrough refreshes the page. In Lightning Experience, if the prompt or walkthrough is related to a specific record, the URL opens the record. If the user doesn’t have access to the record, the in-app guidance opens a record of the same object type and record type, if applicable. The URL opens even if the user previously viewed or closed the in-app guidance, clicked the Action button, or isn’t a part of the profile or permission set. The URL also ignores all schedule settings. If the in-app guidance is inactive, the URL doesn’t open. If you edit the API name of the record or delete the record, the URL changes. ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-sales-iag-264-0-0-production-enus/a45c480e-33d8-4e53-927a-228fcd4ff716/images/icon_note.png) Note If you turn off **Custom In-App Guidance** from the Settings window on the In-App Guidance Setup page, users can still access prompts or walkthroughs by following this shareable URL. See [Turn Off Custom or Installed In-App Guidance](https://help.salesforce.com/s/articleView?id=sales.iag_custom.htm&release=264.0.0&type=5 "Prevent custom prompts and walkthroughs that your company created or installed from appearing on their scheduled instances."). ## Keyboard Shortcuts In-App Guidance Builder supports these handy keyboard shortcuts for Mac and Windows. | Action | Mac | Windows | | --- | --- | --- | | Keyboard Help | ?+Shift+/ | ?+Shift+/ | | Switch focus to different areas of In-App Guidance Builder, such as the header, right sidebar, and left sidebar | Cmd+F6 | Ctrl+F6 | | Switch focus from the environment when you’re navigating back to the In-App Guidance Builder | Cmd+F7 | Ctrl+F7 | | Select the next element in the environment | Ctrl+Alt+t | Ctrl+Alt+t | | Select the previous element in the environment | Cmd + Option + Shift + t | Ctrl+Alt+Shift+t | | Add a targeted prompt to the selected element in the environment | Cmd+Option+a | Ctrl+Alt+a | ## Salesforce Mobile App In-App Guidance isn’t supported in the Salesforce mobile app. #### See Also - [Types of In-App Guidance](https://help.salesforce.com/s/articleView?id=sales.customhelp_iag_types.htm&release=264.0.0&type=5 "Select the appropriate type of in-app guidance depending on the support you want to give to users and the environment that you’re working in.") - [Create Prompts](https://help.salesforce.com/s/articleView?id=sales.customhelp_lex_prompt_add.htm&release=264.0.0&type=5 "Provide helpful content to users where they’re working. Introduce users to new features, draw attention to specific details in their environment, and provide nudges or reminders.") - [Create Walkthroughs](https://help.salesforce.com/s/articleView?id=sales.customhelp_lex_wt_add.htm&release=264.0.0&type=5 "Connect multiple prompts for a hands-on interactive tour that onboards users or introduces features. Each prompt becomes a step in the walkthrough.") - [Limitations for In-App Guidance in Experience Cloud Sites](https://help.salesforce.com/s/articleView?id=sales.iag_site_limitations.htm&release=264.0.0&type=5 "If your company has purchased Enablement, purchased Enablement Partner Relationship Management (PRM), and created an Experience Cloud site built with Aura templates, you can create prompts and walkthroughs in a site. Some functionality that’s available for in-app guidance in Lightning Experience isn’t available for in-app guidance in Experience Cloud sites.") - [Analytics for In-App Guidance](https://help.salesforce.com/s/articleView?id=sales.customhelp_lex_prompt_monitor.htm&release=264.0.0&type=5 "Track views and completion data for prompts and walkthroughs so you can iterate and improve upon your onboarding and discovery strategy. Some quick analytics are available on the In-App Guidance page in Setup, or you can create a custom report type for more in-depth analysis. Some prebuilt, customizable reports and dashboards are available to download from AppExchange.") - [Preview and Test In-App Guidance](https://help.salesforce.com/s/articleView?id=sales.customhelp_lex_prompt_test.htm&release=264.0.0&type=5 "Verify that the prompts and walkthroughs that you created appear correctly for the right users. Quickly preview a prompt or walkthrough in any environment. For in-app guidance in Lightning Experience, perform more thorough quality assurance testing for all prompts and walkthroughs that a specific user can see. Test mode ignores schedule settings, global time delay settings, and user interaction analytics. You can also test prompts and walkthroughs in a sandbox.") - [_Knowledge Article_: In-App Guidance Prompts FAQ](https://help.salesforce.com/apex/HTViewSolution?urlname=In-App-Guidance-Beta-FAQ)