Skip to main content

Adding Citations

Learn how to turn on Citations, link course text to its sources, and export a course with full source traceability for regulated or compliance content.

Platform access level: Org Admins, Managers, and Writers (anyone who builds courses).


Citations link specific text in a course back to the source that supports it, so regulated or compliance-sensitive content stays traceable all the way to review. This guide is for anyone adding source-backed citations to a course, from getting the feature switched on through exporting a course with its citations intact.


1. Get Citations switched on for your organization

Citations is off until Arist switches it on for your organization, so reach out to your Arist Customer Success contact if you want it and don't have it yet. It applies to courses only, not to nudges or surveys.

the course editor's References section with the Citations tab circled beside Sources

Once it's on, a Citations tab appears next to Sources in the course editor's References section, and an Add citation link appears beside the text you can cite.


2. Check your organization's citation style

An Org Admin chooses one citation style for the organization. Check it before adding sources, since changing the style later does not update sources you already have.

See Managing Organization Settings for the available styles, how the setting applies, and how an Org Admin changes it.


3. Add your sources

Sources are the documents or references your citations point back to, and a course needs at least one before you can cite anything.

the course editor's DETAILS panel with References circled, below About course and Settings

Open the course in the editor and select References, where the Sources tab holds the material and the Citations tab holds the links into it.

the Sources tab listing four numbered source entries, with the Add source control circled beneath them

Reference material uploaded when you built the course with Creator appears here as numbered sources. See Building a Course with Creator for the upload steps. To add another source, select Add source and enter it yourself.


4. Create a citation

You can cite text in a lesson body, the welcome message, or a question.

the Add citation control at the top right of a lesson's Body field, circled

Select Add citation at the top right of the text field you want to support with a source. Highlight the passage first if you want it filled in for you.

the Add a citation panel with Source, Source text, and Linked text in content fields

Fill in the three fields on the Add a citation panel:

  • Source: Choose the source that supports the claim.

  • Source text: Enter the excerpt from that source that backs up the claim.

  • Linked text in content: Enter the exact passage the citation applies to. It must match your content word for word to appear in the export.

Select Save. The citation appears in a Citations list under the body's character counter, tagged with its status, like [1a] Needs review.

The number identifies the source. Letters follow reading order, with no gaps after you add or delete a citation. Deleting a source renumbers the sources after it.


5. Review citations and change their sources

Open the Citations tab to review every citation for the course.

Status

What it means

Needs review

A new citation, one whose text you edited, or one Arist matched to slightly revised content

Approved

You've checked the citation and confirmed it's accurate

At risk

Arist could not match the citation's linked text to the content it is attached to

A dropdown above the list filters to one status at a time (All citations, Approved, At risk, or Needs review), so reviewers can find what still needs a look.

the Citations tab filtered to All citations, showing an approved citation's expanded details and citations awaiting review with an Approve button

Select Show details on a citation to see its source text, linked text, lesson, and field. For a citation marked Needs review, select Approve once you've checked it.

Change a citation's source

You can change which source supports a citation without recreating it.

the citation edit form with the searchable Source list open and Cancel and Save below
  1. Open the citation's three-dot menu and select Edit.

  2. Open Source, search if needed, and choose the replacement source.

  3. Select Save.

Changing only the source keeps the citation's letter and approval. Its number follows the new source: for example, [1a] becomes [2a] when you change it from source 1 to source 2.


6. Check citations after editing content

After changing cited content, check whether its citations still support the revised wording.

a citation marked At risk in the Citations list under a lesson body, beside two that still need review

For some small edits, such as changes to capitalization, spacing, or punctuation, Arist can match the citation to the revised passage. The citation then goes back to Needs review. Check that the source still supports the new wording before approving it again.

Other changes can leave a citation At risk when Arist cannot match its linked text to the revised content. A citation already at risk stays at risk until you edit the citation itself.

the Citations tab warning listing the affected lesson, with Show at-risk citations circled

The warning on the Citations tab lists the affected lessons and the number of at-risk citations in each. Select Show at-risk citations to filter the list to the citations that need attention.

an at-risk citation expanded in the Citations tab, showing its linked text no longer matching the current lesson wording
  1. Open the at-risk citation's three-dot menu and select Edit.

  2. Update its linked text to the exact passage in the current content that the source supports.

  3. Select Save. The citation goes back to Needs review.

  4. Check its source and linked text, then select Approve.

When you create an AI-modified copy of a course, citations whose linked text is missing are not copied to the new course. Review the copy's citations before exporting it.

Important: At-risk citations are excluded from every export. Check the Citations tab and fix anything at risk before exporting if you need those citations included.


7. Export a course with its citations

You can download a course with citations as a Word document or a PDF. See Finding and Managing Your Content for the Download menu on the Content page.

the Download course as window with the at-risk warning above Format, Word and PDF choices, and Cancel and Download

If the download window warns that citations are at risk, cancel and fix them on the Citations tab first if you need them included. The warning lists the affected lessons; the Show at-risk citations button is on the Citations tab, not in this window.

Choose Word or PDF, then select Download. The formats present citations differently:

  • Word document: Inserts a small bracketed marker right after each cited passage, then adds a References section listing each cited source, with every citation shown underneath its source as an excerpt and any still needing review marked [Needs Review].

  • PDF: Adds a References section at the end listing each cited source, with any citation still needing review shown underneath its source as an excerpt, and leaves the lesson text without bracketed markers.


Related articles

Note: Need help at any point? Reach out to your Arist Customer Success contact, or email [email protected].

Did this answer your question?