Troubleshooting
Miscellaneous Issues
19 articles
Clear Browser Cache
Published on 2026-08-06
Refer to the following resources for information on clearing the cache in various browsers: Caution Whatfix uses cached information for several actions, including Analytics, Tasklist, and Whatfix...
Error: HTTP Status 500 - Internal Server Error
Updated on 2026-08-06 | Published on 2023-02-10
Issue You get a HTTP Status 500 - Internal Server Error when trying to download an exported package from the Whatfix dashboard. Probable Cause This issue occurs if you do not have an active session of...
Account Locked
Published on 2025-11-28
Issue You are unable to log in to your Whatfix account and you see a message that your account is locked. You may also not receive the password reset email, or the reset link might expire. Possible...
Image icons break for Smart Tips
Updated on 2026-08-06 | Published on 2023-06-21
Issue You have added an image as the Smart Tip icon for your account, but it breaks over certain domains. Probable Causes If you have used PNG icons instead of SVG icons, the image might break....
Issues with Positioning Whatfix Content
Updated on 2026-08-06 | Published on 2023-05-03
When you try to position Whatfix content such as Beacon, Smart Tip, or Launcher on an element of the application, the content may be mispositioned. The Beacon, Smart Tip, or Launcher may not be...
Unable to Add a Tag to Content
Updated on 2026-08-06 | Published on 2023-06-14
Issue Despite a Tag being available for your account, you are unable to add the Tag while adding it to a Flow. Probable Cause The Tag to be added may be a Global Page Tag, which enables content to be...
Unable to use Unordered list formatting
Updated on 2026-08-06 | Published on 2024-02-27
Issue You are unable to use bullet list formatting for any of the tips you create in Flow step, Beacon, or a Smart Tip. Probable Cause The bullet list formatting feature is not available for all users...
Widgets shown indefinitely despite set occurrence
Updated on 2026-08-06 | Published on 2023-08-20
Issue You have set an occurrence limit for Whatfix Widgets (Popups, Beacons, etc.) but they keep showing up for users indefinitely. Probable Cause Sometimes, when a user logs out of an application,...
Content or Widgets are Hidden behind Application Elements
Updated on 2024-11-05 | Published on 2024-07-27
Issue Application menu bar or other elements are appearing over Whatfix content in the underlying application. For example, your Tasklist icon is hidden behind an application menu bar, preventing end...
Content does not appear on my application
Updated on 2025-07-15 | Published on 2024-10-10
Issue Whatfix Content doesn’t load on an application even when you have configured the visibility and display rules correctly. Probable Cause Sometimes, if the URL of the application where you want to...
Unable to upload SVG icons
Published on 2025-03-08
Issue When you try to upload an SVG (Scalable Vector Graphics) icon, the upload fails and Whatfix displays an error message. The issue happens when the SVG icons are not in the required size and...
SVG icons appear cropped
Published on 2025-12-16
Issue When you try to upload an SVG (Scalable Vector Graphics) icon to the icon library , the icon gets cropped around the corners . Suggested Solutions Make the following edits to an icon in a basic...
Error message on character limit of Whatfix Content
Published on 2025-03-08
Issue When adding content to the description box of Whatfix content such as Flows and Smart Tips, you see an error message that states you have reached the desired character limit. The error message...
Error: We ran into an issue and couldn't process your request
Updated on 2025-03-13 | Published on 2025-03-11
Issue When you try to launch the Whatfix application from Okta SIngle Sign-on (SSO) application, the request fails and you see the following error message: Probable Causes Incorrect Relay State : The...
Mismatch between the color of content and tooltip background
Published on 2025-06-27
Issue The background color of the content is different from that of the tooltip background. Probable Cause This may happen when you copy-paste content directly from another source. The regular copy...
Widgets don't appear when the user visits the page
Updated on 2026-08-06 | Published on 2023-10-09
Issue A widget doesn’t load automatically when the user visits the page. The user has to manually refresh the page to see the widget. Probable Cause Whatfix needs to recognize the page where the...
Incorrect text size in Whatfix content
Published on 2025-08-08
Issue The text size in Whatfix content appears incorrectly , even though the correct size is seen on the Guidance Dashboard editor. The following images show how the tooltip text appears on the...
Unable to see the Publish button
Published on 2025-09-22
Issue The P ublish button does not appear on the dashboard for certain users. Probable Cause The Publish button is visible only when content or widgets are in the Ready stage. Additionally, only users...
Error: This content is blocked. Contact the site owner to fix the issue.
Updated on 2025-11-05 | Published on 2024-07-30
Issue When you embed a third party Survey l ink in a Pop-up , the following error message appears: This content is blocked. Contact the site owner to fix the issue . Probable Causes You may see this...