District Objective Library Import (System Admins)


How do I get my learning objectives into Schoology?

When District Mastery has been enabled for an organization, an additional tab will be available in the Import area called District Objectives. To navigate to this area:

  1. Click Tools at the top of any page.
  2. Select School Management in the drop-down menu.
  3. Click Import in the left-hand menu.
  4. Toggle into the District Objectives tab.

This is where you will import your learning objectives file and create your library.



What is a library?

Your District Objective Library is where you will store all of your district’s learning objectives and parent objectives.  Your district will share one library that will contain all of your objectives and settings. Any building taking using objectives from that library will also have the district setting applied to their Standards-Based Gradebook.

Libraries have one critical requirement: All learning objectives in the same library must have the same depth in your district’s hierarchy.  This becomes important when reporting out on higher achievement levels or competencies.

Note: Once you have imported your first learning objective file, you will see a yellow banner on your import tab letting you know the depth of your library. All subsequent import files must have the same depth.

For example, take the following ELA Common Core Standard:

Common Core English Language Arts

Reading: Literature

Grade 4


CCSS.ELA-LITERACY.RL.4.1 is the learning objective.  It has a depth of 4, with 3 parent objectives above it in the hierarchy (Grade 4, Reading: Literature, English Language Arts).  If a district chooses to use this structure, all other learning objectives in the library across the entire district must also have 3 parent levels above it.  For example:

Common Core Math

High School: Functions

Trigonometric Functions


Outside of this requirement, how a district decides to structure their learning objective hierarchy is customizable up to 20 levels.

Many learning objective can be grouped within a parent objective:

Common Core English Language Arts

Reading: Literature

Grade 4











Many parent objectives can live under a single higher level parent objective:

Common Core English Language Arts

Reading: Literature












Grade 1

Learning Objectives

Grade 2

Learning Objectives

Grade 3

Learning Objectives

Grade 4

Learning Objectives

Grade 5

Learning Objectives

Grade 6

Learning Objectives

Grade 7

Learning Objectives

Grade 8

Learning Objectives

Grade 9-10

Learning Objectives

Grade 11-12

Learning Objectives

What information can I include when I import my learning objectives?

Below are the six attributes of objectives in District Mastery.  For additional information and import requirements, please view the Learning Objective Import Specification.

We've also provided this template with the column headers you'll need to get started: CSV Template for District Objective Import




An identifying string or number that is unique across your entire organization. This field can be used for the CASE GUID if you are pulling from a CASE repository, an internal identification system or from the standards organization itself. It can be the same as the title, but does not have to be.

Note: This field is required.


This is the title of your learning objective or parent objective. It can be a short set of words (ex. Range of Reading and Level of Text Complexity) or can come from outside of your organization and used track the standard back to the originating source, such as Common Core or NextGen. (ex. CCSS.ELA-LITERACY.RI.3.10).

Note: Learning objective titles need to be unique across the organization. Parent objective does not need to be unique.


The display name for the learning objective that will appear in teachers' gradebooks and student-facing reports. If left blank, the 'title' above will display by default.


Addition details about the learning objective that will appear in teachers' gradebooks and student-facing reports


The value of objective indicates that this item is a learning objective that can be aligned to materials. The value of parent indicates that this item is intended for organization and reporting; it will contain learning objectives or other parents in your learning objective hierarchy.

Note: You must use the exact terms "objective" or "parent" in your import file. This field is case sensitive and importing any other value will result in an error.


This field is used to identify the learning objective group for a given learning objective or parent objective. All learning objective must have the same number of parents. All parent_id inputs must reference a parent objective in the file or already present in your organization. If no value is given, this item will become a new root at the top of your learning objective hierarchy.


How do I import my first file?

Step 1 — Select file

Once your file has been created, attach the file you would like to import and click Continue.


Step 2 — Match columns

Next, you will be asked to map the fields in Schoology to the fields in your file.  As you select a field from the drop-down menus, examples of data in that column will appear on the right side for you to confirm:


Once you have mapped all the required fields and any optional fields you’ve included, click Next to continue.

Step 3 — Resolve Errors

If there are any errors or issues that need to be resolved in the file, they will appear in this step. Otherwise, you will be taken straight to Step 4.

A few examples of errors you may see include:

Inconsistent number of parents or learning objectives without a parent

  • If any learning objectives in your file contain too many or too few parents, you will be provided with a list of which ones

Missing information in a required field

  • If external id, title or type or left blank, you will be provided with a list of objectives that need to be updated

Broken hierarchies

This could happen in a variety of ways.  A few examples are:

  • If an objective references itself as its parent.
  • If a parent or learning objective references a learning objective as its parent
  • If an objective references a parent that doesn’t exist

Should this occur, you will be provided with an error that provides you with the row and ID of the invalid reference.

Too many characters or invalid characters

The limitations of each field are defined in the specification.  If an import breaks one or more of these rules, the user will be notified during this step.

Step 4 — Confirm

Once any errors in the file have been resolved, the file can be imported by selecting confirm from the step 4 screen:


Depending on the size of the file, this could take a few minutes.  Please leave this tab open while the import processes. Once the import is complete, you will see the following success message at the top of the import screen:


Can I update my objectives with imports?

Once you have imported your first learning objective file, you will see a yellow banner on your import tab letting you know the depth of your library. All subsequent import files must have the same depth.

Also after the first import, you will have an additional option regarding updating your objectives. You can choose between:

  • Don't update existing records: This will leave any objectives previously created in their existing state, regardless of what is included in the new file.
  • Update existing records using external_id: This will map existing objectives in your library to objectives in the file based on the external_id. Any other attributes of the learning objective (other than external_id) will be overridden by the information contained in the file.

>> Continue to: District Objective Library Management
<< Go back to: Intro to the District Mastery Pilot



Article is closed for comments.

Powered by Zendesk