Question 1

Do you support anchor links?

Accepted Answer

We support the ability to scroll the user to certain parts of your content on the same page via anchor (or "jump") links.

To insert an anchor click the anchor icon in the markdown editor. Type a name for your anchor in the dialog and hit insert (Malcolm! will make your text lower case and replace any spaces with a dash)

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/oCqoO1obU2/Insert%20anchor.png (Insert anchor dialog)

To link to the anchor use the create link dialog and find your anchor from the drop down list.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/7oI1UVxRhF/Target%20link%20to%20anchor.png (Target link to anchor)

Malcolm! will then add markdown to your content, you can see an example below

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/TkGY25Md9d/Anchor%20and%20target%20in%20markdown.png (Anchor and target in markdown)

Alternatively you can create your anchors and links directly in markdown, the syntax is as follows

To define your anchor

To link to your anchor

See the video below for a walkthrough of this feature

Question 2

I'd like to open the Overlay embed directly, how do I do this?

Accepted Answer

When you create an Overlay embed we give you two bits of code to add to your page. The first is the master code which you should place just before the closing tag. The second is the inline code which generates the button users click to open the overlay - this goes inside the tags where you want the button to appear. When the user clicks the button the Overlay embed will appear in a modal (pop-up) over your page.

The inline code we give you will look like this -

Sometimes you might want to call the overlay but not use our button. You might want to call it from text or use your own button/graphic or you might want to call it in the background when a user does something else on your page.

You can do this by calling mapi in JavaScript.

The mapi has four methods - open, close, trigger and toggle. Open, close and toggle all return promises (i.e., a function that resolves when the animation is complete or a rejects if something went wrong, e.g., no embed found for the param passed). Trigger is more "fire and forget" - it will call the open function if everything goes well, otherwise it silently fails.

Here is an example using an href link that uses the trigger method to open the Overlay -

Note that you must have our master embed code on your page for the above to work and you need to replace EMBED_ID with your embed ID.

The above may also be useful for customers who are using third party site building systems - sometimes putting inline code into a page on those systems can be restricted so you can't add our inline code to render your button. If you can create inline links you could try using the above example with the trigger method to open the Overlay (again remember you also need the master code on the page).

Question 3

Do you support animated GIFs?

Accepted Answer

Yes you can use animated GIFs in Malcolm! placing them in your FAQs or in Workflows (via the Content element).

You can upload the animated GIF into the media section of MyMalcolm or you can pull in externally hosted GIFs.

This cat has been uploaded to MyMalcolm:

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/WsOiR3iaEG/Cat.gif (Animated Cat.gif)

To pull in external GIFs use the following Markdown syntax:

The above Markdown results in this:

https://media.giphy.com/media/QpWDP1YMziaQw/source.gif (Image Description)

Have fun!

Question 4

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.

Question 5

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 6

Can I embed YouTube or Vimeo videos in my FAQs and Workflows?

Accepted Answer

You can easily embed YouTube or Vimeo videos into your FAQs and/or Workflows. Within the FAQ compose interface press the video icon. This will bring up an area where you can paste the URL of the video you wish to embed.

Insert video dialog in MyMalcolm

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/oFZ9QoY435/screenshot-my.malcolm.app-2023.04.02-17_56_57.png (Insert video dialog in MyMalcolm)

If you want to use some of the embed customisation options that YouTube and Vimeo offer you should use the full embed code from those platforms (rather than just pasting the URL). Paste their embed code into the lower part of the MyMalcolm insert video dialog.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/m6StT5M3j9/Screenshot%202018-11-08%2020.01.41.png (Screenshot 2018-11-08 20.01.41.png)

For Workflows add a content element to your Workflow, then in the Workflow builder click to edit the content element and hit the video icon. This will bring up the same dialog as above.

Question 7

Can I turn tags off?

Accepted Answer

You can turn the display of all tags or individual tags off/on. This will also affect the tag listing/results screens.

This feature can be useful in a number of ways, for example if you are prepping a new tag to go live and want to attach it to all your relevant FAQs/Articles but don't want it to display just yet you can simply leave it switched off until you are ready.

You can turn Tags off globally in Settings --> FAQs --> General (under the "Listings" heading)

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/WW0eQrCvC4/screenshot-my.malcolm.app-2023.04.02-15_42_17.png (Turning tags off globally in MyMalcolm)

Individual tags and their associated listings/results can be turned off via FAQs --> Tags then the three-dot menu to the right of the tag in question

Question 8

How do I delete feedback on an FAQ or Workflow?

Accepted Answer

Feedback collected via Malcolm! can only be seen by suitability authorised team members on your instance but there may be situations where you want to delete it, for example if it contains personally identifiable information and your organisation has a policy that you only want to store this for a certain period of time.

To delete feedback for an individual FAQ select the "Delete data" option in the Analyse section of the FAQ.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/IK3fsFzNON/Delete%20FAQ%20Data%20in%20MyMalcolm.png (Delete FAQ Data in MyMalcolm)

To delete feedback for an individual Workflow select the "Delete data" option in the Analyse section of the Workflow and then select either "Delete feedback data" or "Delete all data" (which will also delete all your completion data)

Question 9

Can I put videos in my FAQs?

Accepted Answer

Yes, the best way to do this is via an external host like YouTube or Vimeo. Find out more here.

Question 10

What are Tags in FAQs?

Accepted Answer

Tags are a way of describing your content and allow an alternate way for your customers to browse FAQ's aside from search and categories.

You can add and manage the tags that are attached to each of your FAQs via the "configure" area.

You may also be interested in invisible tags.