Question 1

Can I restrict some or all of my Team members from seeing and/or exporting submitted Workflow data?

Accepted Answer

Sometimes you may wish to use Workflows but restrict other Team members on your instance from having access to the data that is submitted by your end users.

Here is how to do this

Access is managed via the "Team" section of MyMalcolm.
In that section if you click on a Team Member then select "privileges" you can configure whether a user can see and/or export submitted Workflow data. You can even remove all their access to the Workflow section.
Depending on their settings the Instance Owner and some Team Members may also receive submitted data via email alerts. See more about managing email alerts here.
Regardless of their own preferences Team Members won't receive email alerts relating to Workflow completion if they don't have access to Workflow submitted values and exports.

Some related things to be aware of

Remember that on a Workflow level further email recipients can be added in the "email answers" part of the configure section of the individual Workflow - it may make sense to review this recipient list at the same time you review who on your team has access to end user submitted data.
Be aware that if you are pushing some or all of the submitted data to third party systems via Integrations or Web Hooks then submitted data will potentially be viewable by users in those systems.

We recommend that you review this article to read about GDPR and how it applies to Malcolm! and your users.

Question 2

Can I clear sort options in the Library area of MyMalcolm?

Accepted Answer

Within the Library of FAQs and Workflows in MyMalcolm you can click certain column headings to sort by that column. The first two clicks will vary the sort direction (ascending or descending) and the last click will clear your sort!

Question 3

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 4

Why is my embed not showing?

Accepted Answer

If you've set up an embed but can't see it check these things:

Have you implemented the tags correctly? Double check the tag install instructions
Is the embed published? If it’s not published it won’t show
If you are using them check your URL rules - the rule type could be too strict (e.g. URL is exactly xxx rather than URL starts with xxx) - if you are testing on a dev or test URL you can add this within the URL rule section
Check the scheduling - if there’s a schedule to only show the embed on certain days and/or between certain times that may be having an effect
If you are testing on mobile check you've not disallowed the emded showing on mobile

If you are still having problems please open a support ticket and we'll help!

Question 5

How do I sign up?

Accepted Answer

You can sign up and create a Malcolm! user account by filling in the registration form here.

You will need to verify your account via clicking a link in an email we send to your email so please ensure you use a real email address!

It is free to sign up and have a Malcolm! user account - billing belongs to an Instance rather than a user. See here for more on instances.

Your user account can be attached to one or more instances of Malcolm! and you can easily switch between them. This can be great if your company or organisation are using Malcolm! for various different things or if you are a freelancer and work with Malcolm! across different clients or projects.

Question 6

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 7

Can I mix different billing plans across my instances?

Accepted Answer

Yes. Billing belongs to the instance rather than the user and we currently offer 3 different types of price plan.

Your Malcolm! user account is personal to you and can be attached to any type of Instance. So it's perfectly possible for a user to be attached to variety of instances some of which may be on different price plans.

Question 8

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 9

How can I listen to JavaScript events posted from embeds?

Accepted Answer

Malcolm! embeds fire events on user interactions such as when someone first reads an FAQ, completes a Workflow or performs a search. These events can be picked up on your web page for you to perform custom actions - for example creating an event for your Analytics.

How can I listen to these events?

The first event, mapiload, is fired on the window when the mapi.js library has loaded.

The embeds are then rendered followed by the mapi.onrender event.

To register a listener use the mapi.on function.

We recommend combining the window.addEventListener and mapi.on functions for maximum compatibility especially if your application uses JavaScript page transitions, however if your application reloads the page on each request you could combine these into one.

Once the embeds have rendered use the embed.on function to register listeners.

If you know the ID of the embed (can be found in MyMalcolm) use mapi.findEmbed function.

Alternatively loop through the mapi.embeds array.

Putting it all together your code snippet could look something like this.

What events are available?

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.