You have the ability to customize the Question types shown in the tile view through the question_type_groups init option.
Note: It is not currently possible to customize the features view.
Overview
The question_type_groups init option can be used to change the default groups, such as the title, icon, or modify the order of the groups or templates, and also to create new groups.
This article describes how to use this property in order to do the following:
- Override default group properties
- Reordering groups and templates
- Hiding a group or template
- Defining new groups
Use Cases
This section shows some examples of the use cases of the question_type_groups init option.
In order to modify any default groups, the group reference must be known. Group references are listed in the table below:
Group references table
Override default group properties
Changing group icon and name
The code block below shows how to modify the name and the icon of two default groups:
question_type_groups: [
{
"reference" : "graph",
"name" : "Overridden Graphing",
"group_icon": "https://www.learnosity.com/static/img/features/features_proven.png"
},
{
"reference" : "cloze",
"name" : "Overridden Cloze"
}
]
Reordering groups and templates
Reordering groups
In order to reorder the groups, pass an array of objects, each of which contains a group reference, in the new desired order. Group references can be found here.
question_type_groups: [
{ "reference" : "math" },
{ "reference" : "chart" },
{ "reference" : "graph" },
{ "reference" : "chemistry" },
{ "reference" : "cloze" },
{ "reference" : "match" },
{ "reference" : "mcq" },
{ "reference" : "highlight" },
{ "reference" : "writespeak" },
{ "reference" : "other" }
]
Reordering templates within default groups
In order to reorder the templates within default groups, the group reference must be passed with an array of references in the desired group. This is very similar to how to hide templates, whereby the default references must be extracted and then provided in a new order.
Hiding a group or template
Hiding a default group
In order to hide a groups, pass an empty array for template_references for that specific group.
For example, to hide the Match group:
question_type_groups: [
{
"reference" : "match",
"template_references": []
}
]
Hiding templates within default groups
In order to hide specific templates within a default group, the group reference must be passed with an array of references to show within that group, i.e. rather than explicitly hiding a specific template, the templates you want to show must be specified.
As an example, for the default group "Classify, Match & Order", there are four widgets displayed: "Classification", "Match List", "Order List" and Sort List".
Therefore, in order to hide "Classification", provide the references for the other three, as per the code below:
question_type_groups: [
{
"reference" : "match",
"template_references": [
"1fa22aac-1f88-47f7-941b-3c77759549e6",
"0c7f68f7-2be6-4ae0-8492-0ab78c8d0010",
"63891006-450a-4ffe-9876-74d62efa0152"
]
}
]
Defining new groups
The code block below shows how to create a new group with a custom icon. The template_references must be provided, otherwise the group will not show (this is actually how to hide a group, as described here in this article).
These can be the reference of default templates (See this knowledge base article to get references), or the reference of a custom template, provided via question_type_templates.
question_type_groups: [
{
"reference" : "newGroup",
"name" : "New group with icon",
"group_icon": "https://www.learnosity.com/static/img/logos/learnosity-logo.png",
"template_references": [
"e3a30485-ab2d-4ee8-9d0c-5749e96816c1",
"cb9cb540-05b2-44e0-bef3-1b31727c1c37"
]
}
]
Behavior with other init options
The behavior of this property may not be as expected as it can be affected by other init options. To check, please refer to the table below:
| Question Type Templates | Template Defaults | Group Defaults | Question Type Groups | Behavior |
| not set | false | false | not set | No groups are displayed, only Question types are listed |
| not set | false | false | set | No groups are displayed, only Question types are listed |
| not set | false | true | not set | No groups are displayed, only Question types are listed |
| not set | false | true | set | No groups are displayed, only Question types are listed |
| not set | true | false | not set | No groups are displayed, Question types and default templates are listed |
| not set | true | false | set | If Question_type_groups matches any default templates (via template_references or its references), then the groups with content are shown. Otherwise no groups are shown and Question types and default templates are listed |
| not set | true | true | not set | Default templates are grouped according to default groups |
| not set | true | true | set | Default templates are grouped according to default groups. If any default templates match question_type_groups, these groups are displayed at the beginning. If question_type_groups matches any default template groups, then these default groups are extended, e.g. changed text, or logo, or which templates are shown in the group. |
| set | false | false | not set | No groups, custom template types and Question types are listed |
| set | false | false | set | If custom templates are found in question_type_groups, display the groups, otherwise no groups are displayed |
| set | false | true | not set | Since no default templates are found, no groups are displayed, but the custom template tiles are shown |
| set | false | true | set | If custom templates are found in question_type_groups, display the groups, otherwise no groups are displayed, but the custom template tiles are shown |
| set | true | false | not set | No groups are displayed, default and custom templates and Question types are listed |
| set | true | false | set | If custom or default templates are found in question_type_groups display the groups, otherwise no groups are displayed |
| set | true | true | not set | Templates are grouped by default groups |
| set | true | true | set | Templates are grouped by default groups, and if any templates are found in question_type_groups, these groups are displayed at the top of the group list. If question_type_groups matches any default template groups, then these default groups are overridden, e.g. changed text, or logo, or which templates are shown in the group. |
Default settings
Template groups
Note: to customize the group icon used in the left-hand sidebar, add the group_icon property to the relevant group object with a full path to the custom icon.
[
{
"name": "Multiple Choice",
"reference": "mcq"
},
{
"name": "Fill in the Blanks (Cloze)",
"reference": "cloze"
},
{
"name": "Classify, Match & Order",
"reference": "match"
},
{
"name": "Written & Recorded",
"reference": "writespeak"
},
{
"name": "Highlight and Drawing",
"reference": "highlight"
},
{
"name": "Math",
"reference": "math"
},
{
"name": "Graphing",
"reference": "graph"
},
{
"name": "Charts",
"reference": "chart"
},
{
"name": "Chemistry",
"reference": "chemistry"
},
{
"name": "Other",
"reference": "other"
}
]
Question templates (advanced mode)
See this related article on working with advanced or simple layout modes.
Note: to customize the template thumbnail, change the image property to the relevant template object with a full path (or relative path if hosted on same as host page) to the custom image.
Below shows the default templates and their references - you would only need to specify these if you wish to override any properties, such as the image. See example of full path to image for "Multiple choice - standard" template below. If overriding an existing template (using reference), then if property is omitted (e.g. image), then the default is used.
"question_type_templates": {
"mcq": [
{
"description": "Standard Multiple choice question.",
"group_reference": "mcq",
"image": "https://questioneditor.learnosity.com/latest/img/tiles/templates/mcq.png,
"name": "Multiple choice – standard",
"reference": "9e8149bd-e4d8-4dd6-a751-1a113a4b9163"
},
{
"description": "Multiple choice question with multiple responses.",
"group_reference": "mcq",
"name": "Multiple choice – multiple response",
"reference": "908de244-5c71-4c09-b094-7fb49554f2f9"
},
{
"description": "True or false question.",
"group_reference": "mcq",
"name": "True or false",
"reference": "3egs0b24-5gs8-49fc-fds9-4a450sdg31ca"
},
{
"description": "Multiple choice question with a Block layout.",
"group_reference": "mcq",
"name": "Multiple choice – block layout",
"reference": "33d53a22-1a59-4a03-9671-7f5104edd62e"
}
],
"choicematrix": [
{
"description": "Choice Matrix with 2 option columns in a table format.",
"group_reference": "mcq",
"name": "Choice matrix – standard",
"reference": "14b7af71-e146-4747-aae5-ca71618a5038"
},
{
"description": "Choice Matrix with 2 option columns in an inline format.",
"group_reference": "mcq",
"name": "Choice matrix – inline",
"reference": "f109c77c-390e-4595-93b8-2dbd547251b6"
},
{
"description": "Choice Matrix with 2 option columns in a table Format with stem numeration.",
"group_reference": "mcq",
"name": "Choice matrix – labels",
"reference": "9de82e14-802c-4bea-a635-bf9ad0b622fb"
}
],
"clozeassociation": [
{
"description": "Fill in the blanks drag and drop.",
"group_reference": "cloze",
"name": "Cloze with drag & drop",
"reference": "51a8c1e7-f34f-4faf-b211-da458e891fcb"
}
],
"clozedropdown": [
{
"description": "Fill in the blanks with drop down menus.",
"group_reference": "cloze",
"name": "Cloze with drop down",
"reference": "2fbba51b-e35e-441f-83c7-2662e2e81fa6"
}
],
"clozetext": [
{
"description": "Fill in the blanks with text responses.",
"group_reference": "cloze",
"name": "Cloze with text",
"reference": "457fe101-0667-4a35-b193-b849653acb52"
}
],
"imageclozeassociationV2": [
{
"description": "Fill in the blanks on an image with drag & drop.",
"group_reference": "cloze",
"name": "Label image with drag & drop",
"reference": "6e77b403-8f0c-43af-b464-9450e1ac70dc"
}
],
"imageclozedropdown": [
{
"description": "Fill in the blanks image with drop down menus.",
"group_reference": "cloze",
"name": "Label image with drop-down",
"reference": "f8364191-ada5-4806-83d4-8a36b8fad4b0"
}
],
"imageclozetext": [
{
"description": "Fill in the blanks with a text box on an image.",
"group_reference": "cloze",
"name": "Label image with text",
"reference": "35a850a7-9d3f-4e1c-880a-a340767942b6"
}
],
"classification": [
{
"description": "Drag and drop responses into a grid with 2 columns and 1 row.",
"group_reference": "match",
"name": "Classification",
"reference": "ef2648de-f826-4674-b17d-71e71889d8e6"
}
],
"association": [
{
"description": " Drag and Drop responses to match a predefined list.",
"group_reference": "match",
"name": "Match list",
"reference": "1fa22aac-1f88-47f7-941b-3c77759549e6"
}
],
"orderlist": [
{
"description": "List of Items to be arranged into the correct order.",
"group_reference": "match",
"name": "Order list",
"reference": "0c7f68f7-2be6-4ae0-8492-0ab78c8d0010"
}
],
"sortlist": [
{
"description": "Sort list by dragging items to the Target area into the correct order.",
"group_reference": "match",
"name": "Sort list",
"reference": "63891006-450a-4ffe-9876-74d62efa0152"
}
],
"longtextV2": [
{
"description": "Essay up to 10,000 words which may include text formatting controls.",
"group_reference": "writespeak",
"name": "Essay with rich text",
"reference": "1e6039f8-0676-495d-aca9-108710a51ce5"
}
],
"plaintext": [
{
"description": "Essay up to 10,000 words does not include text formatting controls.",
"group_reference": "writespeak",
"name": "Essay with plain text",
"reference": "0f559437-5072-475e-830d-1fa9d2f6bb0d"
}
],
"shorttext": [
{
"description": "Short text respones.",
"group_reference": "writespeak",
"name": "Short text",
"reference": "4fe6c726-419c-4aff-b189-4a9756a0ffda"
}
],
"audio": [
{
"description": "Audio response with Block layout.",
"group_reference": "writespeak",
"name": "Audio recorder",
"reference": "4e9e4ec1-7441-462f-ad70-d94cbaf0d14e"
}
],
"video": [
{
"description": "Video and audio response.",
"group_reference": "writespeak",
"name": "Video recorder",
"reference": "4e9e4ec1-7437-462f-ad70-d94cbaf0d14e"
}
],
"drawing": [
{
"description": "Allows the use of different drawing tools to draw on an image.",
"group_reference": "highlight",
"name": "Drawing",
"reference": "c20d4103-5214-4cdd-bc17-29c98f0e7c0c"
}
],
"simpleshading": [
{
"description": "Allows users to select areas on a grid.",
"group_reference": "highlight",
"name": "Shading",
"reference": "b30bc5dc-b616-4913-a8b4-b5dd9c43bafd"
}
],
"tokenhighlight": [
{
"description": "User can click words/sentences/paragraphs to be highlighted.",
"group_reference": "highlight",
"name": "Token highlight",
"reference": "47f0db98-79e8-4273-946f-90faf4a2ae49"
}
],
"hotspot": [
{
"name": "Hotspot",
"group_reference": "highlight",
"reference": "f0416e39-72fc-4d40-8d6e-c6f97e621fd4"
}
],
"clozeformulaV2": [
{
"description": "Allows math input in one or more response boxes with advanced auto-scoring.",
"group_reference": "math",
"name": "Math",
"reference": "ef0ab0ba-235f-459d-9380-a4a106280c9a"
}
],
"clozeformula": [
{
"description": "Cloze question type with math formula inputs.",
"group_reference": "math",
"name": "Cloze math",
"reference": "57b0690f-4e99-4bbc-9c8f-aa3074baa495"
}
],
"imageclozeformula": [
{
"description": "Question that supports either math or text input per line.",
"group_reference": "math",
"name": "Cloze math with image",
"reference": "11c9093a-dfd3-4852-b1ee-d5e5c3f032df"
}
],
"imageclozeformulaV2": [
{
"description": "Allows math input on an image with advanced auto-scoring.",
"group_reference": "math",
"name": "Label image with math",
"reference": "76504b1a-8f37-4ab8-bcbf-875c966c72af"
}
],
"multistepmath": [
{
"description": "Allows multiline math input with step-by-step auto-scoring.",
"group_reference": "math",
"name": "Multi-step math",
"reference": "7ebe931e-06b8-4fc8-95d2-c7ec4fbf1239"
}
],
"formulaessayV2": [
{
"description": "Essay question type with a keypad for inputting math",
"group_reference": "math",
"name": "Math essay with rich text",
"reference": "7b810c2c-9100-4ff1-96de-cda23bf34445"
}
],
"graphplotting": [
{
"description": "10 x 10 unit quadrants (600px x 600px canvas) with Point tool.",
"group_reference": "graph",
"name": "Graphing",
"reference": "b7dc8b69-c12a-4c4f-ac17-181ac6e0da26"
},
{
"description": "10 x 10 1st quadrant graph (600px x 600px canvas) with all drawing tools.",
"group_reference": "graph",
"name": "Graphing in the 1st quadrant",
"reference": "f325a114-bb81-4e7f-86e0-1147416a78a8"
}
],
"numberline": [
{
"description": "Place points on a number line.",
"group_reference": "graph",
"name": "Number line with drag & drop",
"reference": "f5c683be-b5e0-421d-a593-f6a59312aba2"
}
],
"numberlineplot": [
{
"description": "Plotting responses on number line.",
"group_reference": "graph",
"name": "Number line with plot",
"reference": "02a2d2fe-c028-42d0-b139-e58a60780928"
}
],
"simplechart": [
{
"description": "Create an interactive Bar chart.",
"group_reference": "chart",
"name": "Bar chart",
"reference": "24f76ba0-24af-4be4-aacf-c31c6efd33e3"
},
{
"description": "Create an interactive Line chart.",
"group_reference": "chart",
"name": "Line chart",
"reference": "8c28ecfd-ab0b-43de-bfac-e572eeb06851"
},
{
"description": "Create an interactive Histogram.",
"group_reference": "chart",
"name": "Histogram",
"reference": "cb9cb540-05b2-44e0-bef3-1b31727c1c37"
},
{
"description": "Create an interactive Dot plot.",
"group_reference": "chart",
"name": "Dot plot",
"reference": "2f93c2f1-f7d9-423a-94c9-5df5aabdddc9"
},
{
"description": "Create an interactive Line plot.",
"group_reference": "chart",
"name": "Line plot",
"reference": "1f20bb6e-8685-4eaa-9c70-ef80b811e483"
}
],
"chemistry": [
{
"description": "Enter complex chemistry. Default response box.",
"group_reference": "chemistry",
"name": "Chemistry formula",
"reference": "e484fac0-4022-4b58-b86f-4a537002f449"
}
],
"clozechemistry": [
{
"description": "Cloze question type with chemistry formula inputs.",
"group_reference": "chemistry",
"name": "Cloze chemistry",
"reference": "36e1da6f-5966-4912-a547-75bffdd77950"
}
],
"chemistryessayV2": [
{
"description": "Essay question type with a keypad that has chemistry symbols by default",
"group_reference": "chemistry",
"name": "Chemistry essay with rich text",
"reference": "c07e5630-e0f4-4d0d-b1f8-3908e0d7e474"
}
],
"imageclozechemistry": [
{
"description": "Question that supports chemistry input per line.",
"group_reference": "chemistry",
"name": "Cloze chemistry with image",
"reference": "4d2a04cb-f8a9-4678-b8c6-0dd4bce25fbc"
}
],
"fileupload": [
{
"description": "Users can upload files from their device.",
"group_reference": "other",
"name": "File upload",
"reference": "8ff43fa9-804b-42e7-9b3e-4cdd7e3a882d"
}
],
"imageupload": [
{
"description": "Users can upload and annotate an image, or annotate a provided image.",
"group_reference": "other",
"name": "Image annotation upload",
"reference": "8ff43fa9-804b-42e7-9b3e-3cdd7e3a882b"
}
],
"rating": [
{
"description": "Allows users to choose a value from a preselected range.",
"group_reference": "other",
"name": "Rating",
"reference": "8e99fa69-b829-4a7d-ae2a-eb935fe3a2c6"
}
],
"gridded": [
{
"name": "Gridded",
"group_reference": "other",
"reference": "f0416e39-72fc-4d40-8d6e-c6f97e621fd5"
}
]
}
Question templates (simple mode)
{
"mcq": [
{
"name": "Multiple Choice",
"description": "Users can select either single or multiple responses.",
"reference": "eaa0fe51-f137-49a2-a1a9-47c79c28c7d1",
"group_reference": "mcq"
},
{
"hidden_sections": [
"multiple_answers"
],
"name": "True/False",
"description": "Users choose either true or false.",
"reference": "40586f0d-6372-4ad7-a410-65a8ec0bc57d",
"group_reference": "mcq"
}
],
"choicematrix": [
{
"name": "Choice Matrix",
"description": "Users choose options from a flexible grid of responses.",
"reference": "10ce17b0-b9c5-40a3-bc91-b183719ddf8d",
"group_reference": "mcq"
}
],
"classification": [
{
"name": "Classification",
"description": "Drag and drop responses into grid with optional columns or rows.",
"reference": "990d3d94-64c0-40c4-8088-d18214b95653",
"group_reference": "match"
}
],
"association": [
{
"hidden": [],
"name": "Match Answers",
"description": " Drag and Drop responses to match a predefined list.",
"reference": "779a8c3b-929d-49d2-a99d-5ae6f21b24db",
"group_reference": "match"
}
],
"clozeassociation": [
{
"hidden_sections": [],
"name": "Fill in the Blanks – Drag & Drop",
"description": "Fill in the blanks by dragging and dropping elements.",
"reference": "85b11ecd-1ea8-45da-be5a-8fdcea17f8cd",
"group_reference": "cloze"
}
],
"clozedropdown": [
{
"hidden_sections": [],
"name": "Fill in the Blanks – Drop Down",
"description": "Fill in the blanks with drop down menus.",
"reference": "36947d1e-60d8-45be-ad7b-97b03e442e6f",
"group_reference": "cloze"
}
],
"clozetext": [
{
"hidden_sections": [],
"name": "Fill in the Blanks – Text",
"description": "Fill in the blanks by typing text into predefined regions.",
"reference": "b77d1ded-0998-4a26-a683-29c470005f29",
"group_reference": "cloze"
}
],
"formulaV2": [
{
"name": "Math Formula",
"reference": "fdb235e7-b15a-4d1a-91d8-6b1721bb2203",
"group_reference": "math"
}
],
"imageclozeformula": [
{
"description": "Question that supports either math or text input per line.",
"name": "Math Cloze Image",
"reference": "aa4839a9-c965-4b86-9897-5d710c515850",
"group_reference": "math"
}
],
"graphplotting": [
{
"name": "Graphing",
"description": "10 x 10 unit quadrants (600px x 600px canvas) with Point tool.",
"reference": "2b180c4d-9c5c-4257-b16a-a296b7b5b548",
"group_reference": "graph"
}
],
"simpleshading": [
{
"name": "Box Shading",
"description": "Allows user to select areas on grid.",
"reference": "63ab5e08-55f3-4afd-a1ef-3749b67c1c38",
"group_reference": "highlight"
}
],
"imageclozeassociationV2": [
{
"description": "Fill in the blanks on an image with drag & drop.",
"group_reference": "cloze",
"name": "Label image with drag & drop",
"reference": "44153115-fa11-42d3-a385-50cd821f08cd"
}
],
"imageclozedropdown": [
{
"name": "Fill in the Blanks – Image Drop Down",
"description": "Fill in the blanks image with drop down menus.",
"reference": "7f6cd8d4-449b-4184-a166-1a1dc42fec9e",
"group_reference": "cloze"
}
],
"imageclozetext": [
{
"name": "Fill in the Blanks – Image Text",
"description": "Fill in the blanks text box on and image.",
"reference": "e591dd60-9340-4e29-afc4-55d796d3c508",
"group_reference": "cloze"
}
],
"longtextV2": [
{
"validation": {
"valid_response": {
"score": 1
}
},
"name": "Essay",
"description": "Essay up to 10,000 words which may include text formatting controls.",
"reference": "23f75aff-c1f3-4c7e-91bb-2becafd2dddb",
"group_reference": "writespeak"
}
],
"audio": [
{
"name": "Audio recorder",
"description": "Users can record audio responses from their device.",
"reference": "1ed372fd-78fc-4681-8898-338a81a176e5",
"group_reference": "writespeak"
}
],
"video": [
{
"name": "Video recorder",
"description": "Users can record video responses from their device.",
"reference": "1ed372fd-78fc-4681-8894-338a81a176e5",
"group_reference": "writespeak"
}
],
"numberline": [
{
"description": "Place points on a number line.",
"name": "Number Line Drag & Drop",
"reference": "d7cf3072-2cc0-4ca9-8a7c-43e74c210db7",
"group_reference": "graph"
}
],
"numberlineplot": [
{
"description": "Plotting responses on number line",
"group_reference": "graph",
"name": "Number Line Plot",
"reference": "1e0565de-66eb-420d-9d75-698849cd343f"
}
],
"orderlist": [
{
"name": "Order List",
"description": "List of items to be arranged in the correct order.",
"reference": "b2296cdf-cd91-496c-9f6a-ea5477990257",
"group_reference": "match"
}
],
"simplechart": [
{
"name": "Bar Chart",
"description": "A question type that allows students to modify a bar chart.",
"reference": "fa2960c7-3dc4-4156-bded-52ca03993f4b",
"group_reference": "chart"
},
{
"description": "Create an interactive Line Chart.",
"group_reference": "chart",
"name": "Line Chart",
"hidden_search_terms": [
"chart"
],
"reference": "0386d74d-a4ea-4a90-af5c-3c80f9ec97ad"
},
{
"description": "Create an interactive Histogram",
"group_reference": "chart",
"name": "Histogram",
"hidden_search_terms": [
"chart"
],
"reference": "bab5809c-19da-45b9-8d4f-887f0ec542c0"
},
{
"description": "Create interactive Dot Plot",
"group_reference": "chart",
"name": "Dot Plot",
"hidden_search_terms": [
"chart"
],
"reference": "27de1d95-8bbb-4609-9fdb-29628be5da56"
},
{
"description": "Create interactive Line Plot",
"group_reference": "chart",
"name": "Line Plot",
"hidden_search_terms": [
"chart"
],
"reference": "b6f0bbb1-0287-4bbe-be5b-e304a3fca949"
}
],
"sortlist": [
{
"name": "Sort List",
"description": "Sort a list by dragging items to the target area in the correct order.",
"reference": "24fe0f4b-7f45-4b42-8c7b-64cdf13bc2a5",
"group_reference": "match"
}
],
"tokenhighlight": [
{
"name": "Token Highlight",
"description": "Users can click words, sentences or paragraphs to be highlighted.",
"reference": "3e75c706-9c2b-4435-a095-433df6aedb9d",
"group_reference": "highlight"
}
],
"fileupload": [
{
"name": "File upload",
"description": "Allows users to upload files from their device.",
"reference": "40f17271-9190-469e-b9da-e9bb57352b62",
"group_reference": "other"
}
],
"imageupload": [
{
"name": "Image annotation upload",
"description": "A question type that allows students to upload and annotate an image.",
"reference": "ca26a751-480d-492f-8048-98c196a3c268",
"group_reference": "other"
}
],
"gridded": [
{
"name": "Gridded",
"reference": "33206948-16bf-4840-a61f-1aac64836b60",
"group_reference": "other"
}
],
"hotspot": [
{
"name": "Hotspot",
"description": "A question type that allows students to select a section on an image.",
"reference": "1918bd26-60ae-461d-aa61-67da53722da1",
"group_reference": "highlight"
}
]
}