--- schema_version: "1" id: 96d8e115c7d35384765c1c3714b8ef8213d7e18879fcb5f30c40c25279ddfb86 title: PromptVersion collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_promptversion.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_promptversion.htm source_site: developer.salesforce.com content_type: documentation content_hash: a0d7cf2307d0b3a46810d96faf693eea3d4d59143bc523a0609456a762a4a101 description: Represents an in-app guidance prompt or walkthrough. Available in API version 46.0 and later. --- # PromptVersion Represents an in-app guidance prompt or walkthrough. Available in API version 46.0 and later. Prompts and walkthroughs help users discover your products and services, adopt your processes, or learn how to use a new feature. Add prompts and walkthroughs in Lightning Experience pages or apps or in supported Experience Cloud site pages. Add an optional action button or link that goes to a URL. Track views, action button clicks, and walkthrough completions. ![Important](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note_important.png) #### Important Where possible, we changed noninclusive terms to align with our company value of Equality. Because changing terms in our code can break current implementations, we maintained this object’s name. ## Supported Calls create(), delete(), describeSObjects(), query(), retrieve(), update(), upsert() ## Special Access Rules To add, edit, manage, and view prompts and walkthroughs in Lightning Experience or in Experience Cloud sites, see [Considerations for Creating In-App Guidance](https://help.salesforce.com/s/articleView?id=sales.customhelp_lex_prompt_consider.htm&type=5&language=en_US "HTML (New Window)") and [Permissions for Creating and Accessing In-App Guidance](https://help.salesforce.com/s/articleView?id=sales.customhelp_lex_wt_license.htm&type=5&language=en_US "HTML (New Window)") in Salesforce Help for permissions. ## Prompts and Walkthroughs in Managed Packages For considerations about including in-app guidance in a managed package, see [Guidelines for In-App Guidance in Managed Packages](https://help.salesforce.com/articleView?id=customhelp_iag_packages.htm&language=en_US) in Salesforce Help. For more information about creating managed packages, see [Create a First-Generation Managed Package](https://developer.salesforce.com/docs/atlas.en-us.pkg1_dev.meta/pkg1_dev/creating_packages.htm). Unmanaged packages must contain a namespace prefix. For more information, see [Register a Namespace for a First-Generation Managed Packages](https://developer.salesforce.com/docs/atlas.en-us.pkg1_dev.meta/pkg1_dev/register_namespace_prefix.htm) and [What happens to my namespace prefix when I install a package?](https://help.salesforce.com/articleView?id=faq_distribution_installing_what_happens_to_my.htm&language=en_US). ## Fields | Field | Details | | --- | --- | | ActionButtonLabel | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Label for the action button or link. Maximum of 25 characters. For a walkthrough, specify this value on the last step. | | ActionButtonLink | Type url Properties Create, Filter, Nillable, Sort, Update Description URL for the action button or link. Maximum of 1,000 characters. You can’t use the GROUP BY option in a SOQL query for this field. For a walkthrough, specify this value on the last step. | | Body | Type textarea Properties Create, Update Description Body content. In API version 60.0 and later, enter up to 4,000 characters for all prompt types. In earlier API versions, enter up to 240 characters for floating prompts and targeted prompts. Enter up to 4,000 characters for docked prompts. For docked prompts, the maximum characters include HTML markup, not just readable text. | | DelayDays | Type int Properties Create, Filter, Group, Nillable, Sort, Update Description Number of days between occurrences. For a walkthrough, specify this value on the first step. | | Description | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Description. Maximum of 255 characters. | | DismissButtonLabel | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Label for the dismiss button of a floating or targeted prompt. Maximum of 15 characters. | | DisplayPosition | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The position of a floating prompt on the page. Valid values are: - TopLeft - TopCenter - TopRight - MiddleLeft - MiddleCenter - MiddleRight - BottomLeft - BottomCenter - BottomRight | | DisplayType | Type picklist Properties Create, Filter, Group, Restricted picklist, Sort, Update Description The type of prompt. Valid values are: - DockedComposer—A docked prompt - FloatingPanel—A floating prompt - Targeted—A targeted prompt. Available in API version 52.0 and later. | | ElementRelativePosition | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The location of a targeted prompt relative to the element. This field is available in API version 52.0 and later. Valid values are: - BottomCenter - BottomLeft - BottomRight - LeftBottom - LeftCenter - LeftTop - RightBottom - RightCenter - RightTop - TopCenter - TopLeft - TopRight | | EndDate | Type date Properties Create, Filter, Group, Nillable, Sort, Update Description The date to stop showing the in-app guidance. For a walkthrough, specify this value on the first step. | | Experience | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description This field corresponds to the **Environment** picklist in In-App Guidance Builder. Available in version 60.0 and later. Possible values are: - Lightning—Default. The in-app guidance is used in a Lightning Experience app or page. - Site—The in-app guidance is used in a supported Experience Cloud site page. | | ExperienceContextId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description Required if the value of Experience is Site. The ID of the Experience Cloud site context associated with the in-app guidance prompt. Available in version 60.0 and later. This field is a polymorphic relationship field. Relationship Name ExperienceContext Relationship Type Lookup Refers To Site | | Header | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Label for the header of a docked prompt. This value is the label contained in the window’s browser bar. Maximum of 36 characters. | | ImageAltText | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Indicates the alt text of an image. Required if ImageLocation or ImageID is specified. | | ImageId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the ContentAsset that holds the image. Required if ImageLocation or ImageAltText is specified. This is a relationship field. Relationship Name Image Relationship Type Lookup Refers To ContentAsset | | ImageLocation | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Indicates the location of the image in relation to the body text. Required if ImageID or ImageAltText is specified. Valid values are: - Top - Bottom - Right, which is for floating or targeted prompts only - Left, which is for floating or targeted prompts only | | IndexWithIsPublished | Type string Properties Filter, idLookup, Nillable, Sort Description Used by Salesforce for efficient querying. | | IndexWithoutIsPublished | Type string Properties Filter, idLookup, Nillable, Sort Description Used by Salesforce for efficient querying. | | IsPublished | Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether the in-app guidance is active (true) or not (false). | | MasterLabel | Type string Properties Create, Filter, Group, Sort, Update Description The label. Maximum of 80 characters. | | ParentId | Type reference Properties Create, Filter, Group, Sort Description ID of the in-app guidance. This is a relationship field. Relationship Name Parent Relationship Type Lookup Refers To Prompt | | PublishedByUserId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the user who activated the in-app guidance. If the in-app guidance is part of a package, this value is the user who installed the package. This is a relationship field. Relationship Name PublishedByUser Relationship Type Lookup Refers To User | | PublishedDate | Type date Properties Create, Filter, Group, Nillable, Sort, Update Description Indicates the date the in-app guidance was activated. If installed from a package, this value is the date when the package was installed. For walkthroughs, this field can only be specified on the first step. | | ReferenceElementContext | Type textarea Properties Create, Nillable, Update Description Used by Salesforce to identify the element that the targeted prompt is associated with. Available in API version 52.0 and later. | | ShouldDisplayActionButton | Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether an action button or link is included (true) or not (false). | | ShouldIgnoreGlobalDelay | Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether the in-app guidance ignores the global time delay and instead shows on page load (true) or not (false). This field is available in API version 48.0 and later. | | StartDate | Type date Properties Create, Filter, Group, Nillable, Sort, Update Description Indicates the date to start showing the in-app guidance. For a walkthrough, specify this value on the first step. In API version 48.0 and earlier, this field is required. | | StepNumber | Type int Properties Create, Filter, Group, Nillable, Sort, Update Description Required for walkthroughs only. Indicates the number of the last step the user viewed or interacted with in a walkthrough. Include up to 10 steps. Numbers must be consecutive without repeated or skipped numbers. Available in API version 49.0 and later. | | TargetAppDeveloperName | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The app’s developer name where the in-app guidance appears. Deprecated in API version 51.0 and later. | | TargetAppNamespacePrefix | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The app’s namespace prefix where the in-app guidance appears. This value must match the target app’s NamespacePrefix in the org that the package is being installed into. Maximum of 15 characters. Deprecated in API version 51.0 and later. | | TargetPageKey1 | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Required. Used by Salesforce to identity the prompt’s page location along with targetPageKey2, targetPageKey3, targetPageKey4, and targetPageType. | | TargetPageKey1Ref | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Used by Salesforce to identify the prompt’s page location along with TargetPageKey2, TargetPageKey3, TargetPageKey4, and TargetPageType. | | TargetPageKey2 | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Used by Salesforce to identify the prompt’s page location along with TargetPageKey1, TargetPageKey3, TargetPageKey4, and TargetPageType. | | TargetPageKey3 | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Used by Salesforce to identify the prompt’s page location along with TargetPageKey1, TargetPageKey2, TargetPageKey4, and TargetPageType. | | TargetPageKey4 | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Used by Salesforce to identify the page location along with TargetPageKey1, TargetPageKey2, TargetPageKey3, and TargetPageType. This field is available in API version 53.0 and later. | | TargetPageType | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The type of page where the in-app guidance appears. | | TargetRecordType | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description Used by Salesforce to determine if in-app guidance is specific to a record type. This field is available in API version 53.0 and later. Relationship Name TargetRecordType Relationship Type Lookup Refers To RecordType | | ThemeColor | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Indicates which custom theme color is applied to the in-app guidance. Required if ThemeSaturation is specified. For a walkthrough, specify this value on the first step. Valid values are: - Theme1—derived from the current brand color - Theme2—derived from the current page background color - Theme3—derived from the current global header color - Theme4—derived from the current app theme color | | ThemeSaturation | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Indicates which color value, or saturation, is applied to the in-app guidance that has a custom theme color. Required if ThemeColor is specified. For a walkthrough, specify this value on the first step. Valid values are: - Dark - Light | | TimesToDisplay | Type int Properties Create, Filter, Group, Nillable, Sort, Update Description Required if recurrences are scheduled. The maximum number of times to show the in-app guidance. Salesforce detects whether the user interacts with the in-app guidance, then determines whether to show the in-app guidance again or cancel scheduled recurrences. Maximum value of 30. For a walkthrough, specify this value on the first step. | | Title | Type string Properties Create, Filter, Group, Sort, Update Description Required. The label for the title. Maximum of 36 characters. | | UserAccess | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Indicates which permissions can see the in-app guidance. Valid values are: - Everyone, which indicates that there’s no permission restrictions - SpecificPermissions, which indicates that only users with all the specific user permissions specified can see the in-app guidance In API version 48.0 and earlier, this field is required. | | UserProfileAccess | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Indicates which profiles can see the in-app guidance. This field is available in API version 48.0 and later. Valid values are: - Everyone, which indicates that there are no profile restrictions - SpecificProfiles, which indicates that users with any of the specified user profiles can see the in-app guidance | | VersionNumber | Type int Properties Create, Filter, Group, Sort, Update Description Required. The number remains 1 since multiple versions aren’t saved in the org. | | VideoLink | Type url Properties Create, Filter, Nillable, Sort, Update Description The embed URL for a video in a docked prompt. Maximum of 1,000 characters. You can specify this field or the image field, but not both. This field is available in API version 48.0 and later. See [Considerations for Creating In-App Guidance](https://help.salesforce.com/s/articleView?id=sales.customhelp_lex_prompt_consider.htm&type=5&language=en_US "HTML (New Window)"). |