--- title: Help Topics slug: guide/help-topics description: Organize and publish help topics in Unaric Guide to provide users with targeted guidance on specific Salesforce features and processes. image: https://archbee-image-uploads.s3.amazonaws.com/10Nod6Ww95R3dPr0k0TCJ/P8UavZaNpnz3vd_axcrUH_unaric-guide.png docTags: createdAt: 2025-07-14T21:24:49.464Z --- Help Topics are content units designed to deliver **embedded, context-aware support** directly within Salesforce. ## How it works Help Topics are created by Help Authors in the Help Portal, linked to specific Salesforce objects (e.g., fields, buttons), and displayed to users in different ways: - **Via QAM**: Help Topics appear as in-page callouts (with green question marks) when users interact with linked fields/buttons. The QAM also provides access to the Help Portal, where users can browse all topics. - **Via Help Portal**: Users access the full content of Help Topics in the Help Portal. - **Via Lightning Utility Bar**: To configure this feature, see [Lightning Utility Bar](docId\:uEPSw7KPduqdei7V-COND). Help topics support multiple formats and options: - Add **rich media** (images, videos). - Link to **other topics** or **external resources.** - Organize content into **trees** or **reading lists.** - Use **Tags** for categorization. - Add **keywords** for automatic cross-linking. - Embed topics at the field level with the **Autoform component.** - Gather user feedback via **comments** and **votes.** Help Topics are stored as native Salesforce records that can be manipulated like any other. Once you create a Help Topic, users can find it using Salesforce search. Clicking on a search result takes the user to the Improved Help Portal - a default viewer for the Topic and any related items. More often, Help Authors, in partnership with System Administrators, will decide to add Help components to key areas of Salesforce page layouts, so Topics are displayed right where users need them. A number of components are available. The most important of these is the Help Topic Viewer. ### Keywords The **Text** tab of the Help Topic editor panel includes a **Keywords** field. Enter a word or short phrase into this box to turn the Topic being edited into the 'destination' to which any other Topic referencing the Keyword will be automatically linked. Links appear in the main, rich text body of Help Topics (i.e., it is the text in their Description fields into which links are inserted). :::hint{type="info"} As of the current release, linking is on the basis of text containing the exact word or phrase entered as the keyword with a space at either side of it. ::: ## Create Help Topics :::hint{type="success"} Focus on one task per Topic (e.g., *"Adding a Contact"* vs. *"Mastering Contacts"*). ::: ### 1. Creation & content definition 1. Open the **Help Portal**, which is accessible via: 1. **QAM**: 1. Open the QAM on any Lightning page it has been added to. 2. Click the Tools button and select **Help Home** to open the Help Portal. 2. **Unaric Guide Application**: 1. Navigate to the Salesforce App Launcher. 2. Select the **Improved Help** app. 3. Click the **Help Topics **tab. 2. Once in the **Help Portal**, click the **Tools** menu (:FontAwesome[]{icon="fa-solid fa-bars"} icon) and select **New Help Topic** to open the creation interface. 3. The creation interface includes several tabs for configuring the topic’s content and settings. You need to save changes in each tab to finalize the topic: ::::Tabs :::Tab{title="Visible"} Defines the topic’s title and brief description for display. ::Image[]{src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcR4kfMibx2ec4KZG2uABIo6kOU-N8M4btp2mPM7Q_e8lF-XVw1goPmceDUqNaWh5qFxR2O-ELc-FfJj0pDtzxioT1aXWWQ5y0ixSqx6DgMyIM0req2rmBo_kDpy68KVITSQl1TNg?key=Nws0keDXgXn5jYtrf6jr4Q" size="50" width="925" height="621" darkWidth="925" darkHeight="621" position="center" showCaption="false"} - **Name**: The Name or *Title* of the Help Topic as it appears in the Help Portal’s Help Topic panel. The name does not need to be unique (there is an underlying Salesforce record ID for data management purposes) but a unique Name makes life easier for all Users when Searching for Help. - **Summary**: A mandatory brief Summary of the Help Topic – a required (non-unique) field that appears under the Help Topic Name in the Help Portal and is used in all Callout Templates. - **Image Properties**: This gives you the ability to embed images within the help you have added around your org. The images are referenced to externally help files, which helps to reduce Salesforce data usage. - **Image URL**: The web address of the image, which should use the `https` protocol to prevent browsers throwing security alerts. - **Image Title**: Short title text that appears above the image in the Help Portal. - **Image Caption**: Short caption text that appears under the image in the Help Portal and Callout Templates that include images. - **Image ALT Text**: Alternative text to support accessibility. - **Image Width & Height**: Set the Image’s size in the Help Portal (use just one dimension to scale proportionally without losing the original image’s aspect ratio). - **Reset Image button**: Clears all image settings and empties the image placeholder in Full & Callout Templates to prevent unexpected layout issues. - **Video settings: **You can embed useful videos which end users will find useful. *Read more here.* - **Video URL**: The web address of the video, which should use the `https` protocol to prevent browsers throwing security alerts. - **Video Title**: Short title text that appears above the video player in the Help Portal. - **Video Caption**: Short caption text that appears under the video player in the Help Portal and Callout Templates that include videos. - **Video Width & Height**: Sets video player size in the Help Portal (use just one dimension to scale proportionally without losing the original image’s aspect ratio). - **Reset Video button**: Clears all video settings and empties the video placeholder in Full & Callout Templates to prevent unexpected layout issues. After finishing editing the Help Topic, copy the ID at the bottom and click **Save** (:FontAwesome[]{icon="fa-solid fa-check"} icon). ::: :::Tab{title="General"} Configures display settings for callouts and Help Portal. ::Image[]{src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXehSukNA4NiPp7Ec_RT00-LujatW3ts7WEG8UopIrzDbLPE4laeNNcNNmSYIEtqegTTmI7aubC_gfRXyNRCdU_I5YQdLFeLI0fp1VpgV0J4SucQfTHrNJAqiNJOsIaP0kOs63w50Q?key=Nws0keDXgXn5jYtrf6jr4Q" size="50" width="537" height="532" darkWidth="537" darkHeight="532" position="center" showCaption="false"} - **Salesforce Help URL**: An optional field used to set any Salesforce Help & Training portal page URL that is directly relevant to this Help Topic. (Where Salesforce Help pages are indirectly relevant to a specific Help Topic, they are better managed as external help Resources, linked to specific Help Topics as a Related Help Resource with contextual Usage Notes.) - **Callout Template**: Sets the layout of the Help Topic when embedded help in a Salesforce page – displayed in a Help Callout; - **Callout Height**: Allows the Help Author to adjust the height of the Callout to balance the Help Topic’s content and space used in the Helped Page. If the Callout Template is changed, Callout Height changes to the default value for that Callout Template; - **Callout Media Choice**: If a Help Topic has both Image and Video media, the Help Author can select which will be displayed in Help Callouts with one media slot per Help Topic. (Note that if a Help Topic is edited and the selected Media removed, Improved Help will switch Callout Media Choice to the remaining option.); - **Preview Callout link**: To save the need for Help Authors to flip between the Help Portal and Helped Pages to see the effect of Callout parameter changes, clicking the Preview Callout link will launch a new window to preview the last (Quick) Saved Callout and a placeholder container to show how the Callout will sit in the Helped Page. - **Full Template**: Sets the default template for displaying the full Help Topic in the Help Portal’s Help Topic Panel. See *Enterprise Help Portal*: Help Topic Panel for more details on Full Template types. - **Height Before Scrolling**: Help Authors can adjust the height at which Help Topics start to scroll when viewed in the Help Portal – to balance visibility of Help Topic content and the related Help Resources panel, which sits below the Help Topic panel. ::: :::Tab{title="Status"} Provides the ability to create custom styles, add sentiments and make the help topic active and inactive. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcMEvNjQplzvibx2gVQxKbWwX4l4-ovBm6ZKe0YEalYGRt-EP16EmjNq1D10X0Zp8eopNHFnQxvDx0YGXjFF56mSmh2mOesRyELy-AErv2V529PE3aYx4klYsPgL9Ec4f76kpqqPg?key=Nws0keDXgXn5jYtrf6jr4Q) - **Active?**: Sets whether the Help Topic is visible to Helped Users:  Help Authors and Administrators can see Topics regardless of this setting. - **Show Read More link?**: Sets whether the Help Topic, when displayed in its Callout, has a link to read all topic details in the Help Portal. - **Show Referring Topics**: Controls visibility of Topics that reference this one in the Related Help Topics listing. Help Topics always include links to related help where Authors have chosen to define these relationships. Global Settings can be used to control whether or not to include Related Help listings for Topics from which the current Topic is referenced. This check box can be used to override Global Settings, ensuring that any referring Topics are always shown for the current Topic. - **Help Topic Status**: Where required, the Help Topic Status field provides a default set of milestones to manage Help Topic’s life-cycle. This is useful for organisations seeking to formalise authoring processes with Salesforce Workflows and/or Approvals. The default picklist values may be overridden at System Administrator level. - **Visibility**: Tag that can be used with data sharing rules (see *Help Domains*) to control Topic availability. The Visibility field is not used by Improved Help itself, but Organisations can choose to create data sharing rules based on the setting of the Visibility field to filter the records seen by different groups of Users. - **Custom Style**: Where defined in Global Settings, some examples are packaged, also allows a custom style to be applied to a Help Topic. The Custom Style field can be used to finesse the appearance of individual Help Topics. To extend these options:  - Help Administrators must define custom styles in the Customer CSS file. - Help Administrators then reference these styles on the Branding tab of the Global Settings page. - Authors are then able to select from the list of custom styles for their Topics. - **Vote Set**: Allow you to capture users sentiment as they engage with your content. See the below section (Adding Feedback and Sentiment) for more information. ::: :::Tab{title="Text"} This is the main tab for adding the vital help which you would like to share with your end users. Help Topic Description is a rich text field, which can be edited using the standard features provided by the Salesforce Rich Text Editor. You can also paste rich text or HTML into this field though be aware that, upon saving, Salesforce will automatically remove or ‘escape’ some HTML elements for security reasons. ::Image[]{src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdPzc2MXhOLSagXi5IpSseGv5nVZc40EBc3KGcgBiPLoYruCSwILrbHUOekM6zlx5l5RshN2WCWEB8k6yu-r_nJ4RXeqyJEIP23C4fLZnxrGpWL9MSLSX6daX_0bpn6Fh62rJs_wA?key=Nws0keDXgXn5jYtrf6jr4Q" size="52" width="930" height="513" darkWidth="930" darkHeight="513" position="center" showCaption="false"} - **Keywords**: Set a keyword for any Help Topic. Use Help Topics individually to define business terminology or definitions /abbreviations used by your business to create a knowledge base of such topics. Ensure each definition Help Topic has a keyword set, then any other Help Topics using the keywords will automatically link to them, like Wiki links / Wikipedia.  ::: :::Tab{title="Guides"} This tab is only relevant if you are using this specific help topic as part of a guide. See [Help Guides](docId\:TipcuA4CBw8Sp8mDQtf64) ::: :::: ### 2. Link Help Topics to fields and buttons :::hint{type="info"} A System Administrator must first add the Autoform Lightning component to the page layout where you want to add embedded help. The Autoform is a replacement for the standard record detail view that enables field-level help. To learn how to add this component, see [Embedded Help Setup](docId:4FdYLQ4XcjOiu-3coKHm6). ::: 1. Copy the **Salesforce ID** of the help topic and navigate to the page of the target object. 2. Click the **Tools menu **button and select **Help Enable**. The page will switch to **Help Enable **mode. ::Image[]{src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfWwqdw1FNBuyDCdEllITMzUP5GOfCaESUvB9ik-G9ttNBtHcZFclRLhMEisodeRO-9IyspvBLQ8xnx-XYvYoNphultvh99aYbgHcrJWifIkckvN4jzImHnJ02ktffo_74nAcEw?key=Nws0keDXgXn5jYtrf6jr4Q" size="32" width="194" height="462" darkWidth="194" darkHeight="462" position="center" showCaption="false" indent="2"} 3. In **Help Enable** mode, any field that can be *help-enabled* will be highlighted in yellow. Click on any highlighted field label or button to mark it for help enablement. ::Image[]{src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdiq5mrKNqIlgoz5OeIhdsykOTAxWxPKD9aRBa_W5acqXiAZwtS9Fr69Fk2P-Xt2mHLvKydpNSBBBA29z4h9EP2zM_9ytUWO7Kh1mjO-OTS-Emt17QC-ixd18z2QI3KXO-QgO4j?key=Nws0keDXgXn5jYtrf6jr4Q" size="100" width="1244" height="564" position="center" caption="‘Help-Enable Mode’ page example." darkWidth="1244" darkHeight="564" showCaption="true" indent="2"} 4. When finished, use the **Quick Access Menu** to return to **View Mode**. 5. You’ll be prompted to: - **Review your selections.** - **De-select** any mistakenly chosen fields or buttons. - **Link help topics** to the newly selected elements. 6. Use the **Salesforce ID** of the help topic (in case you didn't copy it, it is found in the URL of the topic’s page) and paste it into the **Help Topic ID** field for the selected element. 1. Green question mark icons next to field labels, which indicates recent help enablement. 2. Hyperlinks displaying **Newly added help topic -- details pending**, which you can use to add content. 7. After completing the configuration, your help-enabled elements will display: :::hint{type="success"} Select fields in a logical order that matches your users' workflow. ::: ## Lifecycle Help Topics follow a lifecycle status to track their progress. This is especially useful for organizations that employ formal Salesforce Workflows or Approvals in their authoring processes. Track content from draft to archival using **status fields**: ::::WorkflowBlock :::WorkflowBlockItem **Draft**: Initial creation or editing phase. ::: :::WorkflowBlockItem **In Review**: Awaiting validation from designated approvers. ::: :::WorkflowBlockItem **Published**: Visible to end users. ::: :::WorkflowBlockItem **Archived**: Retired but preserved for reference. ::: :::: ### Set up lifecycle status You can configure custom status values in **Global Settings** to match your workflow. 1. Navigate to **Improved Help Settings** **>** **Global Settings**. 2. Under *"Help Topic Status"*, add/edit picklist values (e.g., *"Pending Legal Review"*). ### Make a topic active To make a Help Topic visible to users: 1. Go to the **Status** tab of the Help Topic. 2. Set **Active?** to checked. 3. Save the record. :::hint{type="info"} You can also use the **Show Read More link?** Setting to control whether users can view the full Help Topic in the Help Portal. :::