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

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 3

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 4

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 5

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 6

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 7

How do I write a good Frequently Asked Question (FAQ)?

Accepted Answer

Some top tips for writing a good Frequently Asked Question (FAQ) include:

Think like your customers and try to phrase your title in a way a real customer would ask you a question
Use the brief summary area to provide the initial answer - this is what customers will see in search results and when browsing FAQs
For the full answer you can repeat the Brief Summary information but go into more detail
Try and be concise and punchy with your answer - it can be useful to break up the text with subheadings and bullet points
Don't repeat information if it's available elsewhere - better to link to that information! For example if you have an FAQ answering "What times are you open?" and your opening hours are on your main website your answer can simply be "Our opening hours can be seen on our website here" and you can add a link
If you have images or media (eg a YouTube video) that can help with an answer don't be afraid to include it in your answer - Malcolm! fully supports this and customers love it!
Remember to use tags and categories as that will help your customer find their way to the FAQ
Use the feedback option in Malcolm! as that will let customers tell you if the content is useful or not. Regularly review the feedback you get in MyMalcolm!

Question 8

Can you send me a (VAT) invoice?

Accepted Answer

You can download an invoice / receipt for each payment you've made to us in the Billing Section of MyMalcolm. Select "Invoices/receipts" in the left hand vertical navigation and then click the icon on the right of each row to download the invoice/receipt associated with each payment.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/QTknAMoZwW/screenshot-my.malcolm.app-2019.08.05-11_06_35.png (MyMalcolm Invoices/receipts summary)

If you have paid VAT as part of the payment we've taken from your card your invoice/receipt will show a breakdown of this.

For more information about Malcolm! and VAT see this question.

Question 9

Does the free trial have any restrictions?

Accepted Answer

The free trial follows the quotas for the Team plan, but with a lower limit for file uploads.

A trial therefore allows:

Up to 100 FAQs
Up to 10 Workflows
Up to 5 team members
Fle uploads to a total of 100MB.

If you sign up to a plan via the Billing section of MyMalcolm your restrictions will be lifted. If you have a particular requirement for higher FAQ, Workflow, team members or file upload limits during your trial please get in touch with us to discuss.

Question 10

What is my Hosted Hub?

Accepted Answer

Every instance of Malcolm! comes with a Hosted Hub. This is a website that we host for you. You can customise it entirely to your requirements. You can change the branding, the colours, the fonts, the layout, the copy, the icons etc etc. You can even configure it to work on one of your own domains or sub domains.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/V93ed8Zu51/brand-facebook%402x.png (Hosted Hub on Malcolm!)

If you don't have a current website your Hosted Hub could be your main website. If you already have your main website at www.domain.com you could set up your fully branded Malcolm! Hosted Hub at a sub domain like support.domain.com or help.domain.com or customers.domain.com

Some customers may not wish to do this and instead may wish to integrate Malcolm! into their current website. No problem! We have a whole section in the MyMalcolm Control Panel dedicated to this and there a variety of ways you can bring content and functionality from Malcolm! into your own website. We've also got a plugin for Wordpress and a variety of widgets and further integration options coming soon. Customers on our Enterprise plans can have full progamatic access to Malcolm! content and functionality via our comprehensive API.