Institution pages are updated and maintained through our CMS Discovery (Disco). Below you will find how to navigate disco, edit institution records, and publish institution pages with Disco.

Go to Discovery Service Administration (aka Django Admin, aka Discovery, aka Disco)
https://discovery-internal.edx.org/admin/

Go to Home › Course Metadata › Organizations via the Sidebar, or click:
https://discovery-internal.edx.org/admin/course_metadata/organization/

Find partner institution with one of:

Key (x-moniker), 

Name,

or UUID

You may also be provided with a direct link to the Organization Record.

In most cases, the record will be already set up and will need minimal updates. A record that is marked for updating should already have a Name and Logo. The key areas need to launch a page are:

The rest of the live page is hard-coded. In the example above, everything not circled comes from the page template and is not editable.

The Description field does not take normal text formatting. All formatting will require light html. In the example above, Paragraph tags (<p>) and the link (<a href=””>) are added in Disco after copying the text from the doc attached to the ticket. 

<p><a href=”http://www.colgate.edu”>Colgate University</a> is a highly selective residential liberal arts institution distinguished by the dedication of its faculty and its commitment to global engagement, student-faculty research, off-campus study, sustainable practices, and utilizing technology to enhance the teaching and learning experience.</p>

<p>The university offers its students rigorous and diverse academic opportunities, along with powerful real-world experiences, that equip students with the habits of mind and critical thinking skills to thrive in a wide range of career fields and graduate school programs.</p>

Unless it’s provided in the document or ticket, Spanish description can be ignored. 

A banner image preview should be included in the document with a link to the image files. The only file type that is accepted is .png.

The image file is added to the record by selecting Choose file and locating the file on your local machine (you’ll need to download it from the linked source first)

Due to the way that Discovery and Publisher are linked, there is no publication step to launch an institution page. Instead, pages need to be forced into a preview state to prevent them from going live on the site.

This is managed via Tags

The key tags for preview management are:

Use both.

Setting these tags will cause an institution page to be built at a /secure-preview/ URL and will require password access to view the page. 

The URL construction for preview is:

edx.org / secure-preview / school / [key]

For the two partners referenced in this document it would be:
https://www.edx.org/secure-preview/school/uct for UCT: University of Cape Town
https://www.edx.org/secure-preview/school/ColgateX for ColgateX: Colgate University

To publish an approved preview, simply remove the “Build as Preview” tags and save the record. 

Please note that not all partner institution pages show on https://www.edx.org/schools-partners. If a partner wants to show on the above page, you would need to include the tags: display_on_sitemap and display_on_schools_and_partners_page

If your page is not showing up after you’ve updated the needed fields, added (or removed) the preview tag, and waited for (at least one) site build, reach out to Taylor Jabour or Thao Nguyen for troubleshooting.