Question 1

Is there a limit to the amount of media I can upload? How much media space will I need?

Accepted Answer

Each instance of Malcolm! initially comes with a 0.5GB allocation of file storage space.

Because a web bowser will download all content on a page it's good practice (for page loading speed and also SEO purposes) to try and keep each image on your page under 2MB and not include too many images on any one page. Squarespace have a good general guide here.

Video files should not be uploaded to Malcolm! - instead use YouTube or Vimeo and embed your content - see here for more info.. This offers a much better experience for your users (they get a device/speed appropriate stream) and your page download speed will not be compromised.

If you wish to make large documents available for download consider using a dedicated file hosting service (eg Dropbox, Google Drive, WeTransfer etc) and linking to that from your FAQs. This is better user experience because your user will be made aware of the file size before starting the download.

Remember in particular your mobile users who may be viewing your content via significantly slower connections!

If you do find yourself nearing the limit of your initial allocation contact us to request a higher allocation and we can provision this for you - there is no extra charge for this.

Question 2

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 3

How do I create a Frequently Asked Question (FAQ)?

Accepted Answer

Within MyMalcolm go the FAQ Section and click "Create a FAQ" towards to the top right of the screen.

This will bring up the "compose your question and answer" dialogue. Here you can input the question, an optional brief summary answer (used in search and browse results) and your full answer. For tips on how to write a good FAQ click here.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/FrnZFuskaf/screenshot-my.malcolm.app-2019.07.29-21_44_58.png (Compose FAQ in MyMalcolm)

When composing your FAQ you can use the formating controls in the "full answer" box or directly enter Markdown. Markdown is a great way of quickly adding formatting to textual content. If you've not used it before it can take a minute or two to get used to it but it's very fast to work with once you have got the hang of it. You can click the "Need help with Markdown?" button bottom left anytime for a quick reference Markdown guide.

You can see what your FAQ will look like to your users by pressing the "Preview" button top right. When you have written your content press "Next: Configure" to move onto the configuration options for your FAQ.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/vDpsP666Gj/screenshot-my.malcolm.app-2019.07.29-22_20_03.png (Configure FAQ in MyMalcolm)

In this area you can control various things about your FAQ such as whether an author is shown, what the URL is, your choice of tags, whether the feedback form is enabled and the category or categories the FAQ lives in. You also have various options around whether the FAQ can be seen by search engines, is password protected or not and can be found or not via the Malcolm! search/browse capability. You can even set the FAQ (or versions of it) to publish and un-publish automatically at certain dates and time in the future.

Watch a video guide to creating an FAQ below.

Question 4

How do I change my rating elements from percentages (%) to stars?

Accepted Answer

In addition to the default "Did this help you? Yes/No" percentages style of rating you can now alternatively switch to a star rating system where your users can rate content from 1 to 5 stars.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/13xLIdBegJ/screenshot-homelender.malcolm.support-2021.01.15-16_19_22-2.png (Star ratings in Malcolm!)

The system used is set in the Settings section of MyMalcolm under FAQ or Workflows - look for the "Feedback ratings" area. You can switch between the two methods of rating whenever you wish and you can also use different rating systems for FAQs and Workflows.

Because rating content 1 to 5 stars is a bit more linear than a simple yes/no in response to "Did this help you?" we apply some logic behind the scenes when switching between rating styles. A "Did this help you? - No" is equivilent to 2 stars and a "Did this help you? - Yes" is equivilent to 5 stars, which slightly upweights positive feedback.

Don't forget you can change the colours of your rating elements too. See here for more details on how to do this.

Question 5

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 6

Can I link to a Workflow when a user rates content?

Accepted Answer

When a user rates your FAQ or Workflow you may wish to link to a Workflow from the rating area to collect more detailed, specific information. That Workflow could in turn pass data to your other systems (eg ticketing systems or CRM) via an Integration or Webhook.

This feature can be used in combination with, or as an alternative to, the feedback comments feature.

You can enable this functionality for FAQs 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/VMGzMXACpu/Screenshot%202021-03-11%20at%2008.25.31.png (Post feedback Workflow configuration in MyMalcolm)

Here you can choose the Workflow linked to when the user gives feedback.

The default copy for the link text is "Submit additional feedback" but you can change that via the language file - details on how to do this here.

If you are going to enable this feature it may make sense to turn feedback comments off so all comments are captured in your Workflow. We also recommend you turn off the feedback on the individual Workflow you use for the post Workflow feedback (via the configure tag of the individual Workflow in question). This will avoid the user being asked for feedback on the feedback!

Question 7

How can I use Stripe with Malcolm! to collect payment from my customers?

Accepted Answer

Malcolm! now integrates with Stripe. Stripe is a payment service provider that enables business owners to collect payment from their customers.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/UDbFKeLChy/stripe%402x.png (Stripe and Malcolm!)

With our Stripe integration you can create Workflows in Malcolm! that include fields for your customers to enter their card details and pay for things like products, services, memberships etc or perhaps make a donation towards something.

Here is how to set things up:

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/aioqQzmd4C/screenshot-connect.stripe.com-2021.05.28-17_36_24.png (Connecting Stripe to Malcolm!)

Once you have linked your Stripe account you can create Workflows via the Workflow section as usual and place payment related elements onto those Workflows. Two particular elements to pay attention to are Currency and Payments

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/SlnkSg4slf/screenshot-my.malcolm.app-2021.05.28-18_08_18.png (Currency and Payment elements in MyMalcolm)

Payments is the element where your customer will provider their card details. You can configure the amount your customer is charged via the Payment element settings, or you can optionally ask the customer to enter their own amount via the Currency field - this can be useful in scenarios like donations or account payments where you may wish to offer the customer the choice of the amount to pay.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/tJtuV3NgUY/screenshot-my.malcolm.app-2021.05.28-18_12_35.png (Settings for the Payment element in MyMalcolm)

If you also collect your customers email (and Name) in the Workflow you can optionally use that information to send them a payment confirmation email. You can configre and customise this via the Payment element settings.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/sZjKbFViLz/screenshot-my.malcolm.app-2021.05.28-18_11_48.png (Configuring payment confirmation emails in MyMalcolm)

You can place the Payment element on any page of your Workflow, but the actual payment transaction will not be attempted until the final submit of your Workflow. If there is a problem with the payment details your customer will be returned to the page with Payment element on it and given a chance to update their details and proceed back through the Workflow.

You can see a video walkthrough below.

And there you have it! Taking payments via Stripe is a really powerful and quick to implement feature of Malcolm! Workflows. Taking payments will also work when the Workflow is surfaced via our embeds, widgets and overlays too! If you have questions or need a hand setting things up just contact us and we'll be happy to help.

Question 8

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 9

How do I use your Wordpress plugin?

Accepted Answer

First download the Malcolm! Wordpress Plugin here.

In MyMalcolm! create your embeds as normal - instructions here.

At the end of the Embed creation process when your embed code is generated there is some text which says "Embedding in a Wordpress site?" - if you click that text you will be shown your instance ID and for some embed types you will be shown a shortcode. There is also an option to have this information emailed to you.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/Lglywov3F9/Screenshot%202020-05-24%2022.00.27.png (Embedding in a Wordpress site?)

In Wordpress, install the Malcolm! plugin then goto Settings --> Malcolm! and add your instance ID. Currently on some versions of Wordpress when you add the instance ID and press Save there is no acknowledgement of this but you can verify the instance ID has indeed been saved by navigating away and then back to Settings --> Malcolm!

You can see your instance ID in your URL when you are in MyMalcolm eg, https://my.malcolm.app/instances/XXXXXXXXXX/dashboard. The instance ID is the 10 digit code code shown where the X's are above.

For Widget and Full page embeds this is all you have to do - you can then configure on which pages your embeds appear via MyMalcolm (via the URL rules section of the respective embed).

For inline embeds and overlays you need to position where you would like the embed or the overlay launcher in your content. You do this using the Shortcode. Go to the page or post in Wordpress, make sure you are in code editor (not visual editor) and put the Shortcode where you wish the embed to appear / or the overlay be launched from.

If you have any issues with you embeds not appearing first check these things.

Question 10

Do I need to pay VAT?

Accepted Answer

Value Added Tax (VAT) is the sales tax in the United Kingdom where Malcolm! trades from. The current UK VAT rate is 20%. Our pricing is quoted excluding VAT.

The UK is no longer a member of the European Union (EU) however the VAT rules around UK companies trading with EU based businesses and EU based individuals continue to apply.

Whether VAT is applicable to your purchase of Malcolm! and how we apply it can be summarised as follows:

If you are a UK customer (individual or business): we charge VAT at 20%
If you are an EU Business and supply a valid VAT number (we check it): we will not charge you any VAT
If you are an individual in the EU: we will charge you VAT at your local country VAT - details here (PDF)
If you are a company or an individual not in the UK or in the EU (eg you are in the USA or Australia): we will not charge you any VAT