Question 1

Can I change where the logo on my hosted hub and hosted pages links to?

Accepted Answer

If you add a logo to your theme it will by default link to your hosted hub home page. Sometimes you might prefer to have your logo link back to your main website, or another destination.

You can change where the logo links to and whether that link opens in a new window or not in the header section of your theme.

Question 2

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 3

Can I turn off the Workflow title?

Accepted Answer

If you don't want your Workflow title to display you can set this from the configure screen of the Workflow in question.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/JtWPLTjDHT/Screenshot%202020-08-11%20at%2017.45.24.png (Screenshot 2020-08-11 at 17.45.24.png)

This setting affects both the web and embed versions of your Workflow. If you want the title to display on one type but not the other you could clone your Workflow and use different settings for each.

Question 4

How do drafts, versions, publishing and approvals of FAQs work?

Accepted Answer

Malcolm! has an inbuilt versioning system and optional scheduled publishing and approval functionality.

Versions can be useful if you change the answer to a question but at a later date want to revert the answer back to a previous version.

They can also be useful for compliance and regulatory reasons, eg in the future you might want to review what your FAQ answer was at a certain point in time.

Versions also enable you to "prep" updated content ahead of it going live. For example if you are revising your product or service you might need to update your FAQ content. But you might not want that new updated content to go live until your the changes to your product or service also go live.

How Versioning Works

When you first create an FAQ you are creating a draft. When you have finished editing you publish that draft into a version. When you make a version live that version is then what your customers see.

You can choose which version of content is live via the publishing section of an FAQ. To get to this browse to FAQ via the Library, then once selected go into the Publishing section.

You can also start a new draft based on a published version.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/VB6EF763Ha/screenshot-my.malcolm.app-2019.08.06-19_15_24.png (Versions in MyMalcolm)

How Scheduled Publishing Works

As well as choosing to make a version live immediately you can also choose to make a version live at a certain date and time in the future. You may only want a version to be live for a certain period of time so you may wish to set an end date. You may also want different versions live at different times. You can set this up and manage and edit upcoming schedules in the publishing section of an FAQ.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/6R9cFykdG0/screenshot-my.malcolm.app-2019.08.06-19_30_00.png (Scheduled Publishing in MyMalcolm)

How Approvals Work

The Approval functionality adds a stage between turning a draft into a published version - the draft has to be approved. This functionality can be useful if you work in an organisation where a legal or compliance department wants to review any changes to customer facing communications. It can also be useful if one team member, for example a manager or editor, wants to ensure they personally review all content changes submitted by staff members (or perhaps freelancers) before those changes are allowed to go live.

Approvals functionality is off by default. To turn it on go to the Settings section, General settings, Content approval.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/drOJxuIL5V/screenshot-my.malcolm.app-2020.06.29-17_43_05.png (Enable Approvals in MyMalcolm)

Although you can technically approve your own content the approval functionality makes most sense when you have several team members on an Instance. So it tends to be used by instances that are on our Team or Enterprise plan. You can choose which users on your instance have the approval privilege via the Team section.

Notes can be added to each draft you put forward for approval.

If you are waiting for your content to be approved, or you are a user with the approval privilege you can access your options in the Publishing section. This can be accessed globally (ie showing activity and options across all FAQs) within the first level of FAQ or via an individual FAQ where just activity and options for that individual FAQ is shown. )

Question 5

Can I put tracking (or other) tags in my FAQs / Workflows / Hosted Hub?

Accepted Answer

You can add Javascript tracking tags via the Settings Section of MyMalcolm. Select Tracking tags within that section.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/dcbZzXmJdp/screenshot-my.malcolm.app-2019.07.30-19_55_21.png (Tag management in MyMalcolm)

For Google Analytics you can just add your GA ID.

For users of Google Tag Manager you can add your GTM ID then manage all tags via their interface.

For any other tags add these in the "Any other Javascript snippets" area.

If you wish to use another tag manager you could add that tag managers code in the "Any other Javascript snippets" area and then manage your tags via their interface.

Question 6

How do I switch between Instances?

Accepted Answer

If you are a user on more than one instance you'll see a "My Instances" screen when you login to MyMalcolm.

Once you are in one instance you can also easily switch to another via the drop down that appears at the top of the MyMalcolm interface.

Question 7

How do I build a Workflow?

Accepted Answer

You can build a Workflow quickly via the Workflow Builder in MyMalcolm.

To get started, first go to the Workflow section of MyMalcolm and then click "Create a Workflow" towards the top right of the screen.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/RksXtrNmao/screenshot-my.malcolm.app-2019.07.30-18_58_28.png (Workflows: How would you like to start?)

You can then choose whether to build a Workflow from scratch, start with one of our templates or - if you have already created some Workflows previously - clone one of those previously created Workflows.

You can then use our drag and drop builder to create your Workflow.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/NqeNJgmaNe/screenshot-my.malcolm.app-2019.07.30-18_54_43.png (Workflow Builder)

Our Workflow builder enables you to:

Drag and drop question elements onto your form
Customise those question elements
Configure Filters, Validators and Rules
Split forms over multiple pages
Customise page titles and progress bars
Customise thank you page

Once you have created the content of your form, you can to the Configure tab and configure various options including setting up email notifications or Integrations.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/6t3XACYIqr/screenshot-my.malcolm.app-2019.07.30-19_14_25.png (Configure your Workflow)

By default your Workflow is created as a web form that you access via a URL. But you can also surface that Workflow in a variety of other ways (including float it over page in a widget, via a modal/overlay launched by a button you place on a site, or via embeds or plugins) - take a look at the Share section of MyMalcolm to do this.

Watch a video guide to building a Workflow below.

Question 8

What can I change or customise in the Brand Section?

Accepted Answer

The Brand section of MyMalcolm has many powerful options to help you change the look and feel, layout and content of your Malcolm! Hosted Hub in order to reflect your own brand.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/juvGMA0a3E/brand-facebook%402x.png (Use your own brand with Malcolm!)

Get started by going to the Brand section in MyMalcolm, copying your current theme, then editing things on the copied version.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/xsC67Mdwy8/screenshot-my.malcolm.app-2019.08.06-17_50_20.png (Edit your brand settings in MyMalcolm)

Watch a video guide to customising your look and feel below.

Question 9

How do I use Malcolm! with my own domain or sub-domain?

Accepted Answer

You can use your own domain or sub-domain with Malcolm! There is no extra cost for doing this.

To set this up go to the Settings Section in MyMalcolm then Custom Domains. Enter your custom domain and you will be given instructions on how to verify domain control/ownership and set up your DNS. We can host on SSL too and we'll automatically generate a secure certifcate for you. Once again, there is no extra cost for doing this!

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/x1cCpQ17Io/screenshot-my.malcolm.app-2019.07.30-19_35_49.png (Domain Settings)

Once you have set up your custom domain or sub-domain both that and your malcolm.support / malcolm.app URL will work and serve content. If you don't want the .malcolm domains to work just select the redirect option and any traffic will be redirected.

Watch a video guide to setting uo your own domain below.

Question 10

My verification email has not arrived?

Accepted Answer

Your verification email (to verify your email address) should usually arrive within a few minutes. If it hasn't turned up check your spam folder.

If the email still hasn't arrived after a few minutes there are a few possible reasons:

Occasionally users may accidentally misspel their email address
There could be a temporary issue at our email sending provider (Mailgun) that is delaying emails
There could be a temporary issue at your email provider that is delaying emails
You may have very strict email filtering enabled and don't accept email from new senders (in this case you should update your rules to allow email from support@malcolm.app)
Your email provider may be rejecting email sent by our email sending provider (Mailgun)

The quickest resolution in many cases is simply to register again using a different email address.