Question 1

Can I collect the email address of a user when they leave feedback on an FAQ or Workflow?

Accepted Answer

It can be very useful to offer the ability for a user to leave their email when giving feedback on an FAQ or Workflows so you can follow up with them.

You can turn this feature on for FAQ's and/or Workflows via Settings --> FAQ --> General or Settings --> Workflow --> General respectively.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/Z202OQgYA3/Screenshot%202021-03-11%20at%2008.25.02.png (Leave Feedback email address option in MyMalcolm)

You can enable it for all feedback or just for negative feedback. The default wording shown to the user is "If you'd like a follow up to this comment please leave your email address" but you can change this wording via the language file - see here for more details.

If the user has left an email address, there will be a "click to email" icon displayed next to the feedback in MyMalcolm.

If you'd prefer a user to complete a Workflow when they rate content see this FAQ.

Question 2

My verification email has not arrived?

Accepted Answer

Your verification email (to verify your email address) should usually arrive within a few minutes. If it hasn't turned up check your spam folder.

If the email still hasn't arrived after a few minutes there are a few possible reasons:

Occasionally users may accidentally misspel their email address
There could be a temporary issue at our email sending provider (Mailgun) that is delaying emails
There could be a temporary issue at your email provider that is delaying emails
You may have very strict email filtering enabled and don't accept email from new senders (in this case you should update your rules to allow email from support@malcolm.app)
Your email provider may be rejecting email sent by our email sending provider (Mailgun)

The quickest resolution in many cases is simply to register again using a different email address.

Question 3

Can I turn off feedback comments or enable for negative feedback only?

Accepted Answer

Sometimes you may wish to turn off the ability for users to leave feedback, or perhaps only offer the opportunity for feedback when the content has been rated negatively.

You can configure your preference via the Settings area of MyMalcolm. You can have different settings for FAQs and Workflows.

Look for the "Feedback comments" setting which appears under Settings --> FAQs and Settings --> Workflows

Question 4

Can I enable reCAPTCHA on my Workflows or FAQs?

Accepted Answer

We now support using Google reCAPTCHA on your Workflows and FAQs/Articles.

When enabled, this will offer protection against spam completions of your Workflows and (if you are using them) the submit feedback and send FAQ/Article by email functionality within Malcolm!

You can find out more about Google reCAPTCHA here.

We support:

reCAPTCHA v3
reCAPTCHA v2 - Invisible
reCAPTCHA v2 - Tickbox

You can enable and configure reCAPTCHA for Workflows and/or FAQs independently. So, for example, you could enable reCAPTCHA protection for Workflows but not FAQs. You could also use a different version of reCAPTCHA for Workflows and FAQs.

You can turn reCAPTCHA on via:

Settings --> FAQs --> reCAPTCHA
Settings --> Workflows --> re CAPTCHA

Start by registering your instance with Google which you can do here.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/xynNm0rZqV/screenshot-my.malcolm.app-2023.04.16-22_02_50.png (Setting up reCAPTCHA in MyMalcolm)

Our dialog will show you the information you need to add to Google's interface. You can then paste the credentials you receive back from Google into MyMalcolm.

When enabled, ReCAPTCHA will work across all formats (ie content on your hosted hub, widgets, overlays and embeds).

Question 5

Is Malcolm! GDPR compliant?

Accepted Answer

What is GDPR?

"GDPR" refers to The General Data Protection Regulation 2016/679. This is a regulation in EU law on data protection and privacy for all individuals within the European Union and the European Economic Area. It also addresses the export of personal data outside the EU and EEA areas.

How does it apply to Malcolm?

Malcolm! collects, stores and processes data about our own customers - people signing up to Malcolm! and creating and managing instances.

When talking about GDPR it is important to understand the concept of the Data Controller and the Data Processor.

The Data Controller determines the purposes for which and the means by which personal data is processed
The Data Processor processes personal data only on behalf of the controller.

Is Malcolm! the Data Controller or the Data Processor?

In the context of information about our own customers, eg people who sign up for Malcolm! accounts and manage Instances we are the Data Controller.

In the context of information about your customers, eg information that is collected on your behalf via Workflows you create in Malcolm! we are the Data Processor only. You - as the Data Controller - have the obligation to ensure you are acting lawfully in accordance with the GDPR legislation.

What does all this mean?

When you sign up to Malcolm! you agree to our Terms of Service and our Privacy Policy which detail how we handle your data. By agreeing you give us your consent.

It is important that when you collect, store, process and potentially transfer (via Integrations or Exports) data from your own customers via a Malcolm! Workflow you have your customers consent to do this. Most companies handle this via provisions in their Privacy Policy and/or Terms and Conditions around data processing which their customers agree to. It is therefore good practice to include a check box in your Workflows that reminds customers of your Privacy Policy and their continuing agreement of it and/or confirms their consent for you to collect and process their information

Further Questions

If you have further questions about GDPR or wish to contact our Data Protection Officer you can contact us here.

You can find out more about GDPR here.

Question 6

Can I put the Facebook Pixel on my workflows/forms/FAQs/content?

Accepted Answer

You can easily add the Facebook Pixel to any content you create in Malcolm! such as Workflows and FAQs.

There are two ways you can do this.

The first is to add the Facebook Pixel code directly into the settings area of MyMalcolm - for more details see this FAQ.

The other way is to use Google Tag Manager. You add your GTM container id in the settings area of MyMalcolm and then add your Facebook Pixel via the Google Tag Manager interface.

Question 7

How do I change the colour of my links?

Accepted Answer

You can change the colour of your links via your theme. Themes live in the Brand section of MyMalcolm.

In your main theme settings you'll see link colour options under Primary, Secondary, Tertiary and Body.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/PapJB2lyc6/Screenshot%202021-02-23%20at%2011.22.50.png (Link colour management in Themes)

In embed themes, the link colour is managed from the other colours section.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/Ox2zsXtjRW/Screenshot%202021-02-23%20at%2011.23.15.png (Link colour management in Embed Themes)

In Workflow themes, the link colour defaults to the colour selected in the main theme but can be overridden.

Question 8

Can I put Malcolm! Widget code into another site via Google Tag Manager?

Accepted Answer

If you are using Google Tag Manager on a site or application it is very easy to deploy the Malcolm! widget into that property via GTM.

Here is a step by step guide:

Set up your widget in the Share section of MyMalcolm (there is a guide here) and copy the embed code to your clipboard
In GTM click "Add a new Tag"
In Tag Configuration select a "custom HTML" tag type
Paste in the embed code from your clipboard
You don't need to support document.write
For your trigger use page view on all pages (assuming you want the widget to appear on all pages)

Question 9

How do I write a good Frequently Asked Question (FAQ)?

Accepted Answer

Some top tips for writing a good Frequently Asked Question (FAQ) include:

Think like your customers and try to phrase your title in a way a real customer would ask you a question
Use the brief summary area to provide the initial answer - this is what customers will see in search results and when browsing FAQs
For the full answer you can repeat the Brief Summary information but go into more detail
Try and be concise and punchy with your answer - it can be useful to break up the text with subheadings and bullet points
Don't repeat information if it's available elsewhere - better to link to that information! For example if you have an FAQ answering "What times are you open?" and your opening hours are on your main website your answer can simply be "Our opening hours can be seen on our website here" and you can add a link
If you have images or media (eg a YouTube video) that can help with an answer don't be afraid to include it in your answer - Malcolm! fully supports this and customers love it!
Remember to use tags and categories as that will help your customer find their way to the FAQ
Use the feedback option in Malcolm! as that will let customers tell you if the content is useful or not. Regularly review the feedback you get in MyMalcolm!

Question 10

Do you support a collapsable section in content?

Accepted Answer

If you'd like to have content that has to be clicked to be viewed you can create collapsable sections of content which are closed by default.

Here is an example

Here is the hidden content!

https://media.giphy.com/media/3pZipqyo1sqHDfJGtz/giphy.gif (hello!)

The Syntax is as follows

This above will render a "> Click to open" link on the page which when clicked, will reveal the rest of the content underneath.