ABCDEFGHI
1
FieldRequired?Identifier?Unique?LimitCase sensitive?Illegal charactersSpecial character rulesSubmission Guidelines
2
Knewton Client IDYesYesYesN/AYesDouble quote (“)Your integration team will provide this ID for you as part of the build process.
3
Partner Inventory IDYesYesYesN/AYesDouble quote (“)You may fill this in with whatever alphanumeric ID you’d like to assign to your Content Inventory.

- This ID is equivalent to “graph_id” in the Knewton API.
4
SuperheaderN/AN/AN/AN/AYesAny discrepancy from the templateEvery cell in row 3 of the Content Inventory is considered a Superheader. Superheaders group categories of content data (e.g. “Atom Taxons”).

- Each Superheader therefore must be placed directly above its corresponding Headers (e.g. the “Atom Taxons” Superheader must be placed directly above every column used to submit an Atom Taxonomy).
5
HeaderN/AN/AN/AN/AYesAny discrepancy from the template

For Taxonomies:
- Double quote (“)
- Colon (:)
- Comma (,)
Every cell in row 6 of the Content Inventory is considered a Header.

Headers specify what type of content data (e.g. “Atom Name”, “Learning Objective ID”) is contained by the corresponding column of the spreadsheet.
6
Atom IDYesYesYes40,000 (Atoms and Containers total)YesBackslash as last character (\)

Double quote (“)
If you think your content will exceed the entity limit, please consult your integration team. We will work with you on a solution.
7
Atom NameYes40,000 (Atoms and Containers total)YesAtom names should be in a human-readable format, e.g.,“Chapter 2, Reading Quiz Question 3.”

- If you think your content will exceed the entity limit, please consult your integration team. We will work with you on a solution.
8
Atom TypeYesN/AMust be one of three values:
- Instructional
- Assessment
- Both
9
Atom URLN/AIf available, link to the assessment or instruction content.
10
Instructional TextN/AIf available, include the full instructional text of the Atom here.
11
Question StemN/AIf available, include the full text of the Question Stem here.
12
Answer/ChoiceN/AIf available, include the full text of the answer or answer choice here. Screenshots, text rendered as images, and other image-based answers cannot be submitted.
13
Correct AnswerN/AIf available, include the correct answer choice or full text of the correct answer itself here. Images cannot be submitted.

- Any Correct Answer must accurately reflect your content.
14
ExplanationN/AIf available, the full text of the explanation here. Images cannot be submitted.
15
LO IDYesYesN/AYesTilde (~)

Colon (:)

Pipe (|)

Backslash (\)

Backslash (\) last character

Comma (,)

Double Quote (")
Must be consistently spelled, punctuated, and capitalized.

- Short IDs that reflect your content structure (e.g. LO-01, ALG-24, GR7_CH01_LO03) work best.
16
LO DescriptionN/AYesCannot be submitted without corresponding ID.

- Must be consistently spelled, punctuated, and capitalized.
- Detailed, human-readable descriptions of concrete student learning outcomes work best.
17
LO TypeYesThere are only three valid values: "REMEMBER", "UNDERSTAND" and "APPLY"This column is only required for "fact-based" domains/subjects, where students need to learn e.g. facts and definitions as well as demonstrating a skill; if your content is focused on skills (e.g. math), you do not need to use this column.
18
[Atom Taxon]Yes55 per Atom

2,000 unique Taxons total

7 levels per Taxonomy
YesName of the column = Name of the Taxonomy. You own this name. Illegal characters in the Name of the taxonomy:
Tilde (~)
Colon (:)
Pipe (|)
Backslash (\)
Backslash (\) last character
Comma (,)
Double Quote (")

For the taxon values, a comma (,) is a valid character; it will be escaped in the graph. Double quotes (") and backslashes (\) are illegal.

- Must be consistently spelled, punctuated, and capitalized.
- If you think your Taxonomies will exceed entity limits, please consult your integration team. We will work with you on a solution.
Pipe (|): Knewton always interprets a pipe as the separation between two levels of the Taxonomy.

Tilde (~): Knewton always interprets a tilde as the end of one Taxon value and the start of another Taxon value.

Space: Knewton treats spaces within Taxons as distinct characters. If two Taxon values are identical in the Content Inventory, but one contains a space in the middle of it and the other does not, then Knewton will interpret these as two entirely different Taxons.

Leading or Trailing Space: Knewton always removes spaces at the start or end of a value when processing Inventories.
Name of the column = Name of the Taxonomy. You own this name. Illegal characters in the Name of the taxonomy:
Tilde (~)
Colon (:)
Pipe (|)
Backslash (\)
Backslash (\) last character
Comma (,)
Double Quote (")

For the taxon values, a comma (,) is a valid character; it will be escaped in the graph.

- Must be consistently spelled, punctuated, and capitalized.
- If you think your Taxonomies will exceed entity limits, please consult your integration team. We will work with you on a solution.
19
Pool SizeN/AAnything that is not a positive integerIf you are using algorithmic questions, then the value for Pool Size should reflect the number of times an algorithmically generated version of that question can be seen before the question would feel repetitive to a learner.

- If you are not using algorithmic questions, then do not include Pool Size in your Content Inventory.
20
DifficultyN/AAny character that is not a number between 1 and 3, inclusiveIf you have tagged your assessments with difficulty levels, you should normalize these values to a scale of 1-3.

This cell should be blank for all instructional content.
21
RecommendableN/AAnything that is not "Yes" or "No" Must have a value of "Yes" or "No".
22
Container IDYes40,000 (Atoms and Containers total)YesBackslash as last character (\)

Double quote (“)
Must be consistently spelled, punctuated, and capitalized for all instances of a given Container ID.

- If you think your content will exceed the entity limit, please consult your integration team. We will work with you on a solution.
23
Container Name40,000 (Atoms and Containers total)YesCannot be submitted without corresponding ID.

- Must be consistently spelled, punctuated, and capitalized for all instances of a given Container name.
- If you think your content will exceed the entity limit, please consult your integration team. We will work with you on a solution.
24
Container URLN/ACannot be submitted without corresponding ID.

- Container URL must link to the correct assessment or instruction.
- Each time a Container appears in the graph, enter the same URL in this field.
25
[Container Taxon]Yes55 per Atom

2,000 unique Taxons total

7 levels per Taxonomy
YesColon (:)

Backslash (\)

Backslash (\) last character

Escaped Comma (,)

Double Quote (")
Pipe (|): Knewton always interprets a pipe as the separation between two levels of the Taxonomy.

Tilde (~): Knewton always interprets a tilde as the end of one Taxon value and the start of another Taxon value.

Space: Knewton treats spaces within Taxons as distinct characters. If two Taxon values are identical in the Content Inventory, but one contains a space in the middle of it and the other does not, then Knewton will interpret these as two entirely different Taxons.

Leading or Trailing Space: Knewton always removes spaces at the start or end of a value when processing Inventories.
Name of the column = Name of the Taxonomy. You own this Name. Illegal characters in the Name of the taxonomy:
Tilde (~)
Colon (:)
Pipe (|)
Backslash (\)
Backslash (\) last character
Comma (,)
Double Quote (")

For the taxon values, a comma (,) is a valid character; it will be escaped in the graph.

- Must be consistently spelled, punctuated, and capitalized.
- If you think your Taxonomies will exceed entity limits, please consult your integration team. We will work with you on a solution.