mLevel Content Grid and Question Templates Primer

The mLevel Content Grid

The mLevel Content Grid is the foundation for your mission, allowing you to arrange information to quickly generate questions and provide quality analytics. The Content Grid itself can be created in Excel, and uploaded to mLevel, or created manually within the platform.

The content grid is made up of 4 key elements: the topic, items, attributes, and values.

The Topic is the set of information about which you want your users to learn. In the example above, the Topic is “Smartphones”, but other common Topics include Workplace Safety, Compliance Training, and New Hire Onboarding. A Mission can contain multiple Content Grids, each with their own topic.

Items are examples of the Topic, or the key terms and objectives you want your users to learn about from the content. The examples here are shown as a few words, but they can be anything from single word items to phrases, such as potential customer questions or a list of steps in a process.

Attributes are the qualities or characteristics you want users to know about the Items. Attributes can be broad, and relate to a number of Items, or very specific, and only relate to one. Commonly used Attributes include “Description” and “Product Features.” Attributes are limited to 80 characters for legibility purposes.

Values are the intersections of an Item and an Attribute, typically serving as the answers to questions that will be asked. These are the specific pieces of information that users will learn. The 80-character limit does not apply to values, but they should be kept under about 90 characters for the same legibility reasons. You can also include multiple values per cell by separating them with a pipe bar (|).

mLevel Question Templates

What are mLevel question templates?

mLevel question templates use the information in your Content Grid to quickly generate multiple questions. This saves you from having to manually write questions over and over again or come up with a wide array of incorrect answer options. Questions generated by templates are also tagged using the knowledge intersections from your grid, allowing you to identify what items your users understand and what concepts they may be struggling with.

What types of questions can I ask using templates in mLevel?

Question templates can be used to create True/False, Multiple Choice Single-Correct Answer, or Multiple Choice Multiple-Correct Answer questions.

How does it work?

Question templates work by pulling information from your Content Grid using two dynamic elements: the {{item}} and the {{value}}. Depending on which of these you use, the platform will pull the relevant information into your questions, then display the relevant answers. A True/False statement contains both {{item}} and {{value}} and reads as a sentence. Multiple Choice questions contain either {{item}} or {{value}}, not both. The platform recognizes what to list as the correct answer by matching an Item to the Value on the same row, or vice versa. Incorrect answer options are then determined by displaying Values from the same column that do not match the correct value. An example is shown below:



Can I ask questions in mLevel without a template?

There is also an option in mLevel to manually write questions one at a time and tag them for analytics.

Uploading the Content Grid

Preparing the Grid for Upload

  • After writing your grid, copy and paste the grid itself, without any templates, into a separate worksheet or workbook with your topic in cell A1.
  • Save the worksheet as a .csv file so that only the text of your content grid is saved. 

                                                               Uploading the Grid

  • Log in to the mLevel studio at using your admin credentials.
  • Select the “Learning Content” Tab and click “Add Another Topic”.
  • Click “Browse” and select the file from your computer.
  • Common Errors:
    • “This topic already exists”: There cannot be two grids with the same topic name in a tenant. You’ll have to give your grid a unique name to successfully upload it.
    • “Row X is blank or contains white spaces”: The sheet you’re uploading contains text in a cell outside your grid. Try copy/pasting your grid into its own worksheet again to make sure all the other cells are blank before saving as a .csv file.
    • “Failed to Upload the Topic”: Covers a few errors, but the most likely is that there is a value in your grid that is above 400 characters. Shorten that value or break it into multiple values using the pipe bar ( | ) before uploading.
  • Once your grid is uploaded, you should be able to see it listed in the Learning Content tab.

Uploading a Grid with Special Characters

Certain special characters, such as quotation marks, carrots (< and >), and semicolons may sometimes not upload in the platform and appear as an error symbol �. It is possible to replace that punctuation with the proper character in the platform, but if you have many special characters in your grid, it may be faster to save it as a UTF-8 file, which always uploads those characters correctly. To save your file as a UTF-8:

  • Save the Grid as a .csv using the steps outlined above and close Excel.
  • Open the file using Notepad by opening File Explorer, right clicking the .csv, selecting “Open With”, and selecting Notepad.

  • With the file Open in Notepad, click “Save As”, and choose to save the file as a .csv again. However, next to the save button, there will be a dropdown menu that reads “Encoding: ANSI”. Click that menu and select the UTF-8 option, and then save the file.
  • Upload the grid in mLevel Studio.
  • If you have a Google Docs account, another option to save your grid in UTF-8 is to upload your workbook to google sheets and download the .csv from Google Sheets.
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


Powered by Zendesk