Common Best Practices
  • 25 Jan 2024
  • 1 Minute To Read
  • Dark
  • PDF

Common Best Practices

  • Dark
  • PDF

Article summary

Always test content in your development environment

If you work in multiple environments, it’s a good practice to publish your content on your test environment before deploying it in production.
Test everything2

Organize content using Tags

Adding relevant Tags is a great way to keep your guides accessible and easy to find for your users.
Tag content11

Fore more information, see Tags.

Use contrasting colors for Whatfix widgets

Use contrasting colors for Whatfix widgets, to make them stand out/noticeable on the desktop application. Make sure that your widgets are not lost on your interface.

Use the contrast checker available on this site to help you decide -
Contrast color2

Be clear and concise

Use words and simple sentences. Keep the description in your tip simple and to the point.
Description simple.png

Don't exceed the maximum width in a Tooltip or Pop-up

When inserting images in your content, ensure that they don't exceed the width of the Tooltip or Pop-up to avoid any distorted images.
distorted image2

Monitor the content performance using Whatfix Analytics

Remember to configure Whatfix Analytics to find out how your content is faring. Are your users completing tasks? Which step are they getting stuck at? What search terms do not give any results? You can track this data and use it to improve the performance of your content.

common analytics

Use Control+Shift+V to copy and paste content while translating

When translating content in the UI, avoid copy-pasting content. The formatting of the content could get copied and may generate sync issues. If you have to copy and paste, use the CTRL+SHIFT+V (Windows) or COMMAND+SHIFT+V (Mac) to paste content. These shortcuts copy only the value.

Copy paste

Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.