Question 1

What are invisible tags and how do I use them?

Accepted Answer

Invisible tags are a useful way you can influence search results. Like normal tags they will contribute to search ranking of an FAQ, but they won't be shown on the front-end to your users. If you therefore want a particular phrase to return a particular FAQ but your content doesn't feature that phrase or is being out ranked by another FAQ invisible tags can help.

You can make current tags invisible or set up new invisible tags in MyMalcolm via FAQs / Tags:

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/xOq4M1EP9q/01%20-%20screenshot-my.malcolm.app-2019.10.16-13_56_00.png (Creating an invisible tag)

You then apply tags as usual via the configure area of the individual FAQ:

Question 2

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 3

What are promos and how can I use them?

Accepted Answer

Promos are part of your hosted hub theme and are very flexible multi purpose content areas that appear towards the bottom of your hosted hub homepage (and also your FAQs only and Workflows only home if you are using those).

You can use them to link to content within your Malcolm! instance, for example a particular category, tag, FAQ or Workflow and you can also use them to link out to content or functionality you may have elsewhere. They can be a great tactical tool as well, for example if you've a YouTube channel and want to draw attention to it use a promo!

On our own Malcolm! Help & Support Hub the "Upgrade your content" and "Hey there!" areas are promos.

Promos on Malcolm!

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/j0yBsWZi2d/screenshot-support.malcolm.support-2022.08.03-06_58_32.png (Promos on Malcolm!)

Promos on Malcolm!

Promos are created and managed via your theme (Brand --> Themes).

Promo management in MyMalcolm

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/6O1572FsqO/screenshot-my.malcolm.app-2022.08.03-07_03_19.png (Promo management in MyMalcolm)

Promo management in MyMalcolm

When creating a promo you have various options such as uploading your own background image, plus configuring links

Adding a promo in MyMalcolm

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/QnCg1Rjnpm/screenshot-my.malcolm.app-2022.08.03-07_03_59.png (Adding a promo in MyMalcolm)

Adding a promo in MyMalcolm

Also see featured boxes for similar functionality that enables you to create and manage content towards the top of your hosted hub home page.

Question 4

How do I invite people to join my Instance team?

Accepted Answer

On Team, Team Plus or Enterprise plans you can invite additional Team members to your instance.

To do this go to the Team Section and click "Invite Team Members" towards the top right. You can then enter an email address and choose a role.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/W1UEXwzB1e/screenshot-my.malcolm.app-2019.08.06-20_27_33.png (Invite someone to your Team on MyMalcolm)

The available roles include:

Editor: create and edit FAQs and Workflows
Publisher: as editor but also the ability to publish and approve FAQs and Workflows
Administrator: as Publisher but also access to Instance Billing, Settings, Brand and Team.
Read only: allows a user to view FAQs, Workflows and associated feedback and submitted data
Custom: create the exact permissions you want a team member to have

You can edit and refine the privileges attached to a pending invite by clicking the invite tab, then the email address of the invited user.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/qqiHVb92Hp/Team%20section%20editing%20permissions.jpg (Team member privilege editing in MyMalcolm)

You can also edit the notifications Malcolm! will send to a team member (or pending team member once they accept their invitation) via the notifications tab.

Question 5

What is an Instance?

Accepted Answer

An instance is a collection of related FAQ’s and/or Workflows that your users will see and interact with plus a set of management tools that you and other members of your staff or team will use.

Each instance also includes an optional hosted hub that you can customise and brand.

If you decide to use Malcolm! in two distinct areas of your business it can make sense to have two different instances. For example you could use one instance of Malcolm! to support customers of your product or service and another instance as an internal HR portal.

You can see some examples of how Malcolm! instances can be used here

Instance Billing

Our billing is based around instances. You can start an instance any time and enjoy a 14 day trial. This can be great for trying ideas out. If you want to keep using the instance beyond 14 days you'll need to choose a plan and give us your card details, or agree an enterprise plan with us.

Instance Owners

Each instance will have an owner. This is the master user who is ultimately responsible for the instance. If you are on a Team or Enterprise plan you can invite other users to the instance too. If you need to transfer ownership of the instance to another user (for instance if you are leaving a company or organisation) you can do that as long as the proposed new owner agrees.

Question 6

Can I send the person who completes a Workflow an email?

Accepted Answer

If you want to send the user who completes a Workflow an email you can do this by creating an email answer rule and specifying the "to" email address as the email address supplied in the Workflow.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/iqjmD58nO8/screenshot-my.malcolm.app-2022.04.20-13_07_20.png (Configuring email answer in MyMalcolm)

Note that you can edit the sender name, subject line and email contents in this same create email answer dialogue.

To edit the sending email address see this FAQ and to change the branding/design of the email that is sent see this FAQ.

Question 7

Can I translate or change the system text and labels my users will see?

Accepted Answer

In addition to the FAQ and Workflow content that you create in MyMalcolm you can now change all the system generated text and labels your users see and interact with in the front end of Malcolm!

This means you could, for example, completely translate all the parts of Malcolm! your users will see into a different language.

The majority of the system text is stored and changed within your theme. Themes live in the Brand section of MyMalcolm.

Quite a few bits of system text can be changed contextually as you browse around the sections of your theme, however for the complete list of text you can change go to the "advanced" tab. Here you will have access to your custom language file. The language file stores any changes to the default system text. You'll see any changes you've already made in the other parts of the theme interface reflected here.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/E6kdxuV8w9/screenshot-my.malcolm.app-2020.08.12-00_01_21.png (Edit your language file in MyMalcolm)

At the bottom of the screen you will see two buttons.

Show dictionary - this will show you a complete list of system text items with some further information about where the text is used
Show language file - this will show you all the default values for system text

You can copy the key and default value for a bit of text, paste it into the custom language file window and then edit it. The part you want to change is on the right hand side.

For example, if you wanted to change the text next to the send FAQ by email functionality to be "Please email me" you would add the following to your custom language file

"Heading: Email this answer": "Please email me",

Please note that a few items of system text your users will see are configured elsewhere in MyMalcolm:

The default values, placeholder text, validation message, tooltip title and descriptions used within Workflows are configured in the Workflow builder - you click on the content element when it's been placed on a page in the builder to edit these items
Window titles and button text for Embeds are managed within the visual style section of the respective embed in the Share section (although you can change the default values used via the language file)

Question 8

How do I leave Malcolm?

Accepted Answer

If you want to leave an instance you can ask the owner of any instance(s) you are a member of to remove you.

If you are the owner of an instance and you wish to delete that instance you can do this via MyMalcolm (in the Settings section).

If you no longer wish to be responsible for an instance but you want the instance to live on you can transfer ownership to somebody else via the settings section of MyMalcolm. The new owner must agree to take over responsibility for the instance. Remember that billing belongs to an instance so you may wish to update the billing details of an instance before you transfer it to someone else.

If you want to delete your user account please contact us.

We are always sorry to see people leave Malcolm! so if there is a particular reason or issue that is causing you to leave and you think we might be able to help please do contact us and let us know.

Question 9

What are Integrations?

Accepted Answer

Integrations are a way of passing data you collect in a Malcolm! Workflow into other third party software or systems.

We currently offer integrations with:

Plus over 1,500 over apps via Zapier (more info here) and Make (formerly Integromat) (more info here).

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/v5lAa3NjkY/zapier-fb%402x.png (Malcolm! Integrations)

Configuring Integrations

Once you have created your Workflow, go to the Configure section and select Integrations. There you can link your third party accounts at our integration partners to your Malcolm! Instance by providing your credentials. Once your accounts are linked you can configure integrations with that partner and choose the data from your Workflow that is passed across. You can configure whether data is passed on every Workflow completion or only when certain conditions are met. It is possible to have multiple integrations so, for example, you could create a form which collected details from a new customer including a copy of their ID. You could then subscribe that new customer to a Mailchimp mailing list and store their uploaded ID documents in your Dropbox account by creating two integrations.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/5KmZGb3Q9Q/screenshot-my.malcolm.app-2019.08.06-19_50_53.png (Integrations in MyMalcolm)

Customer Consent

A reminder that it is good practice - and in certain territories a legal requirement - to ensure that your customers actively consent to their data being passed to third party companies who, like Malcolm!, act as data processors on your behalf. You act as the data controller. Most companies handle this consent via provisions in their Privacy Policy which their customers agree to. It is good practice therefore to include a check box in your Workflows that reminds customers of your Privacy Policy and their continuing agreement of it.

Integration Failures

Sometimes integrations may fail. This could be for a variety of reasons, for example the integration partner's API's may be down and/or there may be a problem with your account at the third party provider (for example your Dropbox account may be over quota).

Firstly don't worry re losing customer data - Malcolm! will always store any user submitted data so if there is a problem with an integration

When a problem occurs we'll create a notification to let you know and periodically retry the integration. You can review the Integration logs and retry a failed integration event manually via MyMalcolm (navigate to the Workflow via Library then select Integration logs).

More Integrations coming soon!

We will be adding more and more integrations to Malcolm! in the coming months. If there is a particular integration you'd like us to add please let us know.

Question 10

What does Malcolm! cost?

Accepted Answer

We offer four types of plan and pricing - they can be viewed here.

We bill on a per instance basis - you can read more about instances here.