Question 1

How do I change my social share image?

Accepted Answer

Your social share image is the image that may appear when you share a URL from your hosted hub on social networks (like Facebook or LinkedIn) or in text messaging applications (like WhatsApp)

By default all pages have a generic image.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/Q6c9P9gVRH/Screenshot%202024-06-25%20at%2018.17.27.png (Generic Malcolm! social share image)

You can change this and set your own default social share image in your theme (in the general tab of your individual theme settings)

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/uOPooHQX3d/Screenshot%202024-06-25%20at%2017.56.47.png (Social share settings in your theme in MyMalcolm)

There are then a number of optional overrides that you can apply if desired:

on each individual FAQ/Article or Workflow you can change the social share image for that individual piece of content in Configure --> Meta content
for each author, category or tag, if you have set the respective listing to index, you can change the social share image in the meta section of the listing settings
for the hosted hub home you can change the social share image in Settings --> Instance --> Meta content
for the individual FAQ/Article home (if enabled) you can change the social share image in Settings --> FAQs --> Meta content
for the individual Workflow home (if enabled) you can change the social share image in Settings --> Workflows --> Meta content

You can use a site like https://socialsharepreview.com/to check your social share images are coming through as intended.

Question 2

Can I receive an email every time a new FAQ or Workflow is published?

Accepted Answer

Sometimes it can be useful to receive an email when a new FAQ or Workflow is published on your instance. This feature is turned off by default - to turn it on follow these steps.

From the MyMalcolm control panel area, click your name at the top of the screen where it says "Logged in as"

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/LgmiVqgthh/screenshot-my.malcolm.app-2020.01.16-10_57_39.png (MyMalcolm navigation bar)

You'll then be taken to your personal preferences. If you select the "Notifications" tab on the left you'll be able to edit the notifications you receive. Remember to hit "Save" once you are done!

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/FVf5EupLg4/screenshot-my.malcolm.app-2020.03.03-17_26_08.png (Your notification settings in MyMalcolm)

Note that your notifications are based on an instance. If you are a user on more than one instance you should first switch to the instance you wish to adjust notifications for. You can do this using the drop down selector at the top right of the screen. You can therefore have different notification preferences for different instances. The notification preferences you choose are personal to you and will not affect the notifications of other team members on an instance.

Question 3

How can I send custom emails to my customer, team or suppliers when a Workflow is completed?

Accepted Answer

When a Workflow is completed you can use the email answer functionality to send an email to the person who completed the Workflow, a member of your staff/team, a supplier or anyone else you like.

You can use rules to only send the emails when certain conditions are met (eg when certain values are selected on the Workflow)

You can also configure who that email comes from and what it looks like.

Using the email picker functionality you can additionally create a unique email template into which you can place data supplied by the customer on the Workflow they have just completed. Using all these features together gives you in effect full "mail merge" capability.

You'll see the picker icon in the body area when you go to set up an email answer and choose to customise the email content.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/n6dY5MtLxo/Email%20picker%20icon%20in%20MyMalcolm.png (Picker icon in edit email body dialog)

This will bring up a dialog which lets you choose a value from the Workflow and place it in your email body. You can also choose to show the field name as well if desired.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/Epwr02sjsu/Inserting%20a%20Workflow%20value%20using%20the%20picker%20tool%20in%20MyMalcolm.png (Inserting a Workflow value using the picker tool in MyMalcolm)

You can place the values within your email body as shown below

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/RyYGLAvRJj/Editing%20an%20email%20answer%20in%20MyMalcolm%20using%20values%20placed%20by%20the%20picker.png (Editing an email answer in MyMalcolm using values placed by the picker)

You can also see a Walkthrough of how to do this in the video below

Question 4

Can I change the reply-to email address of an email answer alert to be the person who completed the Workflow?

Accepted Answer

Email answers are automated emails sent by Malcolm! when a customer completes a Workflow. You can send these emails to members of your team, your suppliers, the customer or anyone else you'd like.

Sometimes it can be useful to set a reply-to address for these emails. This can be a fixed value or a value supplied by a customer when completing a Workflow (eg their email address)

To use this feature, when creating your email answer, toggle the custom email setting

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/qR57A24eot/Enabling%20the%20option%20to%20customise%20the%20email%20theme%2C%20sender%20and%20content%20in%20MyMalcolm.png (Enabling the option to customise the email theme, sender and content in MyMalcolm)

Then you'll see an option to either type a reply-to address or assign a field from the Workflow for this value.

Question 5

How does Password Protection of Content (FAQs or Workflows) work?

Accepted Answer

Malcolm! let's you password protect individual items of content (e.g. a particular FAQ or Workflow) and/or your Hosted Hub.

The best option for you will depend on how exactly you use and implement Malcolm!

Password Protection on Hosted Hub

You can add a "start of session" password to your Hosted Hub via the Visibility tab in the Settings section in MyMalcolm.

In this area you can add one or more passwords. For example you could add one password that all your users share, or you could give each user an individual password. You can supply a label/description next to the password in MyMalcolm to remind yourself who that password was created for. From the same area you can suspend or delete previously created passwords, as well as see when passwords were last used.

When a user visits any page on your Hosted Hub they create a web session. The first time they do this they will be asked for their password.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/f2uGLquUY3/Screenshot%202019-04-23%2010.55.25.png (Screenshot 2019-04-23 10.55.25 (2).png)

Password Protection on Individual Content Items

You can also add configure password protection on individual items of content like an FAQ or a Workflow. You do this via the Visibility tab in the Configure section of the individual FAQ or Workflow (which you access via the library in the respective FAQ or Workflow section of MyMalcolm).

The default setting for items of content is that they inherit the settings from the Hub. So if no password is set at a Hub level no password is required to view the content. If a password is set at a Hub level then a password will be required at the start of the user session. If you want to ensure that a password is always required before a particular FAQ or Workflow is accessed you should set it at this content level. Bear in mind however that if you also have a Hub password set and a user starts their session with a direct link to individual content that is password protected they will need to enter two passwords: one to get them into the Hub session and a further password to view the content.

You can also set an individual item of content to never require a password, even if the Hub has a password set. This can be useful if, for example, you want to put all your content behind a Hub password but want to create a Workflow that lets people request access. In this scenario you would create a Workflow for the purpose of requesting access, set it to never require a password then link to it from the text you can configure on the Hub password request screen. When requests come in you can review them and if you approve you can manually set up the user's password.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/I3VJyQJ4IZ/Screenshot%202019-04-23%2010.57.05.png (Screenshot 2019-04-23 10.57.05.png)

Also worth noting

If a user makes three failed password attempts they will not be able to attempt a further password within that session for 30 minutes.

Auth0

We also support managing user passwords via Auth0- see more details here and via Memberstack - see more details here.

Question 6

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 7

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 8

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 9

When a Workflow is completed will I be sent an email?

Accepted Answer

When a user completes a Workflow, by default all the Team members of the instance (who are added and manged via the Team section of MyMalcolm) will receive an email.

You can also configure other people to receive an email on a Workflow by Workflow basis.

To do this:

In MyMalcolm go to the Workflow section
Click Library and then click on the Workflow you wish to configure email alerts for
Then click "Configure" on the black horizontal navigation then "Email Answers" on the left hand vertical navigation
Click "add a new email address" to add a new recipient. This can be a fixed email address you enter or, if you collect an email address on your Workflow, you can choose for the email to be sent to the supplied email
Note that you can also make a recipient conditional - this is very useful if you only want an email to be sent to a particular address when certain criteria on a Workflow are met

Question 10

Can I turn off automatic email alerts?

Accepted Answer

Malcolm! will automatically send you email alerts when certain activity happens on your instance, such as a user leaving feedback or a Workflow being completed. Wherever possible we aggregate these alerts so you receive fewer emails but if you'd rather not receive them you can easily turn them off.

To do this, from the MyMalcolm control panel area, click your name at the top of the screen where it says "Logged in as"

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/LgmiVqgthh/screenshot-my.malcolm.app-2020.01.16-10_57_39.png (Logged in Navigation in MyMalcolm)

You'll then be taken to your personal preferences. If you select the "Notifications" tab on the left you'll be able to edit the notifications you receive. Remember to hit "Save" once you are done!

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/aez6lFczno/screenshot-my.malcolm.app-2020.01.16-11_03_51.png (Manage your notifications in MyMalcolm)

Note that your notificatons are based on an instance. If you are a user on more than one instance you should first switch to the instance you wish to adjust notifications for. You can do this using the drop down selector at the top right of the screen. You can therefore have different notification preferences for different instances. The notificiation preferences you choose are personal to you and will not affect the notifications of other team members on an instance.

If you are the owner of an instance, you can edit the notifications members of your team receive. To do this go to the Team section, click on the name of the team member in question then select notifications. Remember to hit save when done. Also note than you can assign the permission for a team member to be able to edit other team members notifications via the permissions tab.