Add Comments to Your LMS via LTI 1.3

1. Sign in to FastComments and go to your LTI 1.3 Configuration page.
2. (Optional) Pick the platform you're connecting from the Platform dropdown - it sets the display label, but Auto-detect works fine.
3. Click Generate URL. A one-time Registration URL appears (valid for 30 minutes, single-use).
4. In your LMS, open the LTI 1.3 Dynamic Registration screen and paste the URL into the Tool initiation registration endpoint (or equivalent) field. Submit.
5. Your LMS calls back to FastComments, exchanges keys, and creates the integration. The popup closes itself when done.
6. Back in FastComments, the new configuration appears in the Existing Configurations table. The tool is now available inside your LMS courses.

FastComments LTI 1.3 has been tested against:

• D2L Brightspace (any version with LTI Advantage)
• Moodle 4.0+ (External Tool plugin, LTI Advantage)
• Blackboard Learn (SaaS and Ultra)
• Sakai (versions with LTI Advantage support)
• Schoology (Enterprise, Dynamic Registration where available)

Any other LMS that implements the IMS LTI 1.3 Advantage spec with Dynamic Registration should also work - select Other LTI 1.3 platform from the platform dropdown when generating your registration URL (get it here).

Canvas LMS uses a different setup flow (per-developer-key configuration JSON instead of Dynamic Registration). See the dedicated Canvas LMS installation guide.

Navigate to LTI 1.3 Configuration

Sign in to FastComments and go to your LTI 1.3 Configuration page.

If your account doesn't yet have LTI access, you'll see "LTI not enabled for this account" - contact support to enable it on your plan.

Pick a Platform (Optional)

Under Generate a Dynamic Registration URL, use the Platform dropdown to tell FastComments which LMS you're connecting:

• D2L Brightspace
• Moodle
• Blackboard Learn
• Sakai
• Schoology
• Other LTI 1.3 platform

You can also leave it on Auto-detect. The platform is read out of your LMS's openid-configuration during registration; the dropdown only seeds the display label for the resulting configuration.

Generate the URL

Click Generate URL. FastComments creates a one-time registration token and shows you a URL that looks like:

https://fastcomments.com/lti/v1p3/register/<long-token>

Copy it. This URL:

• Is single-use - once your LMS calls it successfully, the token is consumed.
• Expires after 30 minutes if not used.
• Should be kept private - anyone with the URL can register a tool against your tenant within those 30 minutes.

Existing Configurations

Once a registration completes successfully, the new configuration shows up in the Existing Configurations table on the same page, with its Platform, Issuer, Client ID, and Status. You can delete configurations from this table if you ever need to unregister.

D2L Brightspace exposes Dynamic Registration through the LTI Advantage admin interface. You will need administrator access.

Open the Registration Screen

1. Sign in to your Brightspace instance as an admin.
2. Navigate to Admin Tools > Manage Extensibility > LTI Advantage.
3. Click Register Tool. (The direct URL is https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

Paste the URL

You'll see a registration form. The key field is Tool initiation registration endpoint (some Brightspace versions label it "Tool Initiation Registration URL").

Paste the FastComments registration URL (get it here) into that field. Leave the other fields blank - they're auto-populated by FastComments during the registration handshake.

Click Register.

Approve the Tool

Brightspace opens a popup that talks to FastComments, exchanges keys, and shows a confirmation screen. The popup closes itself when registration completes.

The new tool appears in your LTI Advantage tool list. By default Brightspace marks new tools as disabled - flip the toggle to enabled so your courses can use it.

Add a Deployment

In Brightspace, LTI tools need a deployment before they can be used in courses:

1. Open the newly-registered FastComments tool.
2. Click View Deployments > New Deployment.
3. Give the deployment a name (e.g. "FastComments - All Courses"), pick the org units it should be available in, and save.

After the first launch through this deployment, FastComments pins the deployment_id to its configuration record - subsequent launches from a different deployment under the same client will be rejected unless you re-register.

Using Moodle? We also publish a dedicated Moodle plugin for FastComments with a tighter integration than LTI 1.3 (grade sync hooks, deeper activity reporting, native Moodle settings UI). See the Moodle plugin installation guide. The LTI 1.3 flow below is the right choice if you want a single registration that also covers other LMSes, or if your Moodle admin won't install third-party plugins.

Moodle 4.0+ supports LTI 1.3 Dynamic Registration through the External Tool plugin.

Open the Tool Management Screen

1. Sign in to Moodle as a site administrator.
2. Navigate to Site administration > Plugins > Activity modules > External tool > Manage tools.

Paste the URL

You'll see a card labeled Tool URL. Paste the FastComments registration URL (get it here) into the text field and click Add LTI Advantage.

Moodle opens a registration screen showing the tool's identity and the permissions it's requesting. Review and click Activate (or Register, depending on Moodle version).

The popup closes when registration completes; the new FastComments tool appears in the Tools list with the status Active.

Make It Available

By default Moodle adds new tools to the "Course tools" list but doesn't show them in the activity picker. To expose FastComments course-wide:

1. Click the gear icon on the FastComments tile.
2. Under Tool configuration usage, choose Show in activity chooser and as a preconfigured tool.
3. Save.

Instructors can now add FastComments to any course through Add an activity or resource > FastComments.

Blackboard Learn SaaS and Ultra support LTI 1.3 Dynamic Registration.

Open the Tool Provider Screen

1. Sign in to Blackboard as a system administrator.
2. Navigate to Administrator Panel > Integrations > LTI Tool Providers.
3. Click Register LTI 1.3 / LTI Advantage Tool.

If you only see "Register LTI 1.1 Provider", your Blackboard version doesn't support LTI 1.3 yet - upgrade or contact Blackboard support.

Paste the URL

Paste the FastComments registration URL (get it here) into the Client ID / Registration URL field (Blackboard's labeling varies by version). Submit.

Blackboard performs the registration handshake with FastComments and shows you a confirmation screen.

Approve and Enable

Blackboard marks newly-registered tools as Approved but excluded by default:

1. Find the FastComments entry in the tool provider list.
2. Open the menu and choose Edit.
3. Set Tool Status to Approved.
4. Under Institution Policies, review what user data is sent (name, email, role). Save.

The tool is now available to instructors when they add content to courses.

Sakai

Sakai supports LTI 1.3 Dynamic Registration on releases with LTI Advantage. From the Administration Workspace:

1. Sign in as a Sakai admin and open the Administration Workspace.
2. Choose External Tools > Install LTI 1.3 Tool.
3. Paste the FastComments registration URL (get it here) and submit.
4. Approve the tool when the handshake completes.

The tool then appears under External Tools and can be added to sites by their maintainers.

Schoology

Schoology Enterprise instances support LTI 1.3 but Dynamic Registration availability varies by deployment. Check with your Schoology account manager.

If Dynamic Registration isn't available on your Schoology instance, you'll need to configure the integration manually using these endpoints:

• OIDC Login URL: https://fastcomments.com/lti/v1p3/login
• Target Link URL: https://fastcomments.com/lti/v1p3/launch
• Public Keyset URL (JWKS): https://fastcomments.com/lti/v1p3/jwks
• Redirect URLs: https://fastcomments.com/lti/v1p3/launch

After Schoology gives you a Client ID and Deployment ID, contact FastComments support to register the configuration on your tenant.

Other LTI 1.3 Platforms

Any LMS that follows the IMS LTI 1.3 Advantage spec should work with the same registration URL (get it here). Look for a setting labeled "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint", or similar.

If your platform only supports manual LTI 1.3 setup, use the four endpoints listed in the Schoology section above and contact support to finalize.

This page covers adding FastComments to a Brightspace course after an administrator has registered the tool and created a deployment. If the tool is not registered yet, see the D2L registration guide first.

FastComments embedded as a unit topic in Brightspace

Brightspace ships two content authoring experiences: Classic Content and the New Content Experience (also called Lessons). Both expose FastComments, but the menu paths differ. Each section below covers both where they diverge.

Locate the FastComments Tool

The FastComments tool appears in two places inside a course content editor:

1. The activity picker, reached from a module/unit's Add Existing button (labeled Add Existing Activities in older Brightspace versions). FastComments shows up directly in the picker in current Brightspace builds; older versions nest it under an External Learning Tools submenu. Either path adds FastComments as a standalone topic.
2. The Insert Stuff dialog inside the HTML editor, under LTI Advantage. This embeds FastComments inline in an HTML topic via the LTI deep linking flow.

If FastComments does not appear in either picker, the deployment is not enabled for the org unit holding the course. Ask your Brightspace administrator to open Admin Tools > Manage Extensibility > LTI Advantage > FastComments tool > View Deployments, open the deployment, and add the course's org unit (or a parent org unit) under Org Units.

Add FastComments as a Topic in a Module

Classic Content:

1. Open the course and click Content in the navbar.
2. Select the module that should hold the discussion (or create one via Add a module).
3. Click Add Existing (older Brightspace: Add Existing Activities > External Learning Tools).
4. In the picker, click FastComments. Brightspace creates a topic in the module and returns you to the content view.
5. Click the new topic. Rename it to something descriptive like FastComments Discussion using the inline title editor.

New Content Experience (Lessons):

1. Open the course and click Content.
2. Open the unit and lesson that should hold the discussion.
3. Click Add > Existing Activity and select FastComments (older Brightspace: nested under External Learning Tools).
4. The activity is added to the lesson.
5. Click the activity title to rename it.

The first time any user (instructor or student) opens the topic, FastComments initializes the thread for that resource link. The thread is bound to the resource link ID, so renaming or moving the topic does not change which thread is loaded.

Embed FastComments Inline in an HTML Topic

Use this flow when you want comments to appear below a reading, video, or other content inside the same topic page rather than as a separate topic.

1. Open or create an HTML topic in the module/lesson.
2. Click Edit HTML to open the Brightspace HTML editor.
3. Place the cursor where the comment thread should appear.
4. Click the Insert Stuff button (puzzle-piece icon in the editor toolbar).
5. In the Insert Stuff dialog, scroll to LTI Advantage and click FastComments.
6. FastComments opens a deep linking picker. Confirm the placement (the default options work for content discussions); click Insert or Continue.
7. Brightspace returns to the HTML editor with a placeholder block representing the LTI launch. Click Save and Close on the topic.

When the topic loads, Brightspace replaces the placeholder with an iframe that auto-launches FastComments via LTI. Students see the discussion thread inline.

A single HTML topic holds multiple deep-linked FastComments embeds. Each embed gets its own thread because each deep link produces a distinct resource link ID.

Module Topic vs Inline Quicklink

Pick the module topic approach when:

• The discussion is the primary activity for that step in the module.
• You want the topic to appear in Brightspace's table of contents, completion tracking, and Class Progress.

Pick the inline embed approach when:

• Comments should sit below other content on the same page.
• You do not want a separate completion-trackable item in the table of contents.

Visibility, Draft, and Release Conditions

A new FastComments topic is visible to students by default. To hide it while you set it up:

1. In the content editor, click the topic title (Classic) or the three-dot menu on the activity (New Content Experience).
2. Set status to Draft (Classic) or toggle Visibility off (New Content Experience).

Draft topics are invisible to students. Instructors and TAs still see them with a "Draft" badge.

To restrict the topic to a specific group or section:

1. Open the topic.
2. Click the topic title menu > Edit Properties In-place (Classic) or Edit > Restrictions (New Content Experience).
3. Under Release Conditions, click Create.
4. Pick Group enrollment or Section enrollment, select the group/section, and save.

Release conditions stack with FastComments's own role mapping. Students who cannot see the topic do not get an LTI launch.

What Students See on First Launch

When a student clicks the topic (or loads an HTML topic with an embed):

1. Brightspace performs the LTI 1.3 launch in the background.
2. FastComments receives the student's name, email, avatar URL, and LMS role, and signs them in automatically. There is no FastComments login prompt.
3. The comment thread for that resource link renders inside the Brightspace iframe.

Role mapping at launch:

• Brightspace Administrator becomes a FastComments admin for the thread (full moderation, delete, ban, and configuration access).
• Brightspace Instructor becomes a FastComments moderator (pin, hide, delete, ban).
• All other roles (Learner, TeachingAssistant, etc.) become standard commenters.

Comments are attributed to the student's Brightspace account. If the student edits their name or avatar in Brightspace, the next LTI launch syncs the change.

Iframe Height and Resize

FastComments emits the org.imsglobal.lti.frameResize postMessage on every thread render and on content changes (new comment, expand replies). Brightspace listens for this message and adjusts the iframe height so the thread is not clipped and does not show an inner scrollbar.

If the iframe stays at a fixed short height:

• Confirm the course is loaded over HTTPS. Brightspace's postMessage listener rejects mixed-content frames.
• Confirm no browser extension is blocking the postMessage channel.
• For inline embeds in an HTML topic, the surrounding HTML must not wrap the iframe in a fixed-height container. Remove any inline style="height: ..." from the parent element.

Brightspace-Specific Gotchas

Tool not showing in the Add Existing picker. The deployment is not enabled for this course's org unit. An administrator needs to add the org unit (or a parent) to the deployment's Org Units list. Tool registration alone is not enough; the deployment scopes which courses see the tool.

deployment_id mismatch on launch. FastComments TOFU-pins the first deployment_id it sees for a registration. If an administrator deletes the original deployment and creates a new one, launches from the new deployment are rejected with a deployment mismatch error. The fix is to re-register FastComments (generate a new registration URL (get it here) and run Dynamic Registration again); the old configuration record is replaced.

Tool launches but shows "Invalid LTI launch". The course is in a different tenant/org structure than the deployment covers, or the deployment was disabled after registration. Re-check Admin Tools > Manage Extensibility > LTI Advantage > FastComments > Enabled toggle and the deployment's org unit list.

Names and roles missing inside FastComments. Brightspace ships LTI launches with Names and Role Provisioning Services (NRPS) claims. If a course was upgraded from an older LTI 1.1 link, the launch lacks name and email claims. Re-add the FastComments topic via Add Existing (do not migrate the old link) so the launch uses LTI 1.3.

Embed shows a login screen instead of auto-SSO. The HTML topic was inserted as a plain <iframe> pointing at FastComments rather than via Insert Stuff > LTI Advantage. Plain iframes skip the LTI launch and land users on the public-facing FastComments page. Delete the iframe and re-insert via the Insert Stuff flow.

Once an administrator has registered FastComments as an LTI 1.3 Advantage tool and approved the institution policies, instructors add it to courses through the standard Blackboard placement points. The exact steps differ between Ultra Course View and Original Course View, so both are covered below.

Ultra Course View

Ultra Course View is the default in Blackboard Learn SaaS as of 2026.

1. Open the course and go to the Course Content page.
2. Hover or tap where you want the comment thread to land in the outline and click the purple + (Add content) button.
3. Choose Content Market. The Content Market panel lists every approved LTI tool and Building Block placement for your institution.
4. Find the FastComments tile and click it. Blackboard creates a content item at the position where you opened the + menu.
5. The item lands in the outline as a "Visible to students" entry by default for instructors who have Hide from students off as their personal default. If your default is Hidden, the item is created hidden and you flip the visibility selector on the item row when you're ready.
6. To rename the item, click the title in the outline and type a new label. The title students see in the outline is independent of the FastComments thread identifier, so renaming is safe at any time.

If you don't see Content Market as an option, your institution has the placement hidden. You also reach the same picker through More tools in the same + menu under the LTI Tools group.

Original Course View

Original Course View is still supported in Learn SaaS and remains the primary experience for self-hosted Learn 9.1 sites on the Q4 2024 CU release line.

1. Open the course and enter a Content Area (for example, the default Information or Content area in the course menu).
2. Turn Edit Mode on with the toggle in the top-right of the page.
3. Click Build Content in the action bar.
4. Under the Learning Tools submenu, click FastComments. The Learning Tools submenu is populated from LTI 1.3 tool placements after an administrator registers the tool. If you don't see it, see the gotchas section below.
5. On the Create FastComments form, set:
   • Name: the label students see in the content area.
   • Description: optional text shown above the embedded thread.
   • Permit Users to View this Content: Yes/No availability toggle.
   • Track Number of Views: enable if you want Blackboard's per-item view statistics. FastComments runs its own analytics independently.
   • Date and Time Restrictions: optional Display After / Display Until windows.
6. Submit. The tool appears as a clickable item in the content area.

Embedding Inside an Item or Document

In both course views, instructors embed FastComments inline inside the body of an Item, Document, or any rich-text field through the Content Editor's LTI Advantage button.

Ultra Course View:

1. Create or edit a Document.
2. Click Add content inside the document body where you want the thread to appear.
3. In the editor toolbar, open the Insert content menu and click Content Market (the LTI Advantage / Deep Linking entry point).
4. Pick FastComments. FastComments returns a deep-link payload and Blackboard inserts an embedded block in the document body at the cursor position.
5. Save the document. Students see the thread rendered inline as they scroll past it.

Original Course View:

1. Edit any item with a rich-text body.
2. In the Content Editor toolbar, click the Add Content plus icon and choose Content Market (labeled Add Content from External Tool in older Q4 2024 CUs).
3. Pick FastComments. The editor inserts a placeholder block referencing the deep-linked resource.
4. Submit the item.

Each deep-link embed produces its own FastComments thread, so an Item with two embedded FastComments blocks has two independent comment streams.

Visibility, Release Conditions, and Group Restrictions

FastComments content items behave like any other Blackboard content item for the access control rules layered on top of them.

• Ultra: click the visibility selector on the row (Visible to students, Hidden from students, Conditional availability). Conditional availability supports date/time windows, performance rules against gradebook items, and member rules against course groups.
• Original: open the item's context menu and choose Adaptive Release or Adaptive Release: Advanced to gate the tool by date, membership, grade, or review status. Use Set Group Availability on the item to restrict to specific course groups.

FastComments respects whatever Blackboard's gate decides. If Blackboard hides the item from a student, the LTI launch never happens for that student and they don't appear in the moderator view.

Gradebook Behavior

FastComments does not report grades back over LTI Advantage Assignment and Grade Services. No grade column is auto-created for FastComments content items.

If your Blackboard tenant is configured to auto-create a gradebook column for every new content item regardless of grading metadata, an empty column appears anyway. To hide it:

• Ultra: open the Gradebook, click the column header, choose Edit, and turn off Show to students plus Include in calculations. Or use Delete if your institution permits column deletion for ungraded items.
• Original: open the Grade Center, click the column's chevron, choose Hide from Users (on/off), and optionally Hide from Instructor View under Column Organization.

What Students See

When a student opens the FastComments item or scrolls to an embedded block:

1. Blackboard launches the LTI 1.3 message to FastComments. The student is signed in via SSO using their Blackboard identity (name, email, avatar, role) without seeing a login form.
2. The comment thread renders in the iframe. Threading, replies, mentions, and reactions are all available based on the comment widget settings configured in FastComments.
3. Their comments are attributed to their Blackboard account. If the student edits their name or photo in Blackboard later, the next launch updates the FastComments profile.

Role mapping from Blackboard to FastComments:

• System Administrator and Course Builder map to FastComments admin.
• Instructor and Teaching Assistant map to FastComments moderator.
• Student, Guest, and Observer map to FastComments commenter.

Moderators see moderation controls (pin, hide, ban, delete) inline on every comment in the thread.

Thread Scoping

FastComments scopes each thread by (Blackboard host, course ID, resource link ID). Two FastComments items in the same course produce two threads. The same item copied across two course shells (for example, through course copy) produces two threads, because Blackboard issues a fresh resource link ID during the copy. To keep a shared thread across course copies, use Deep Linking with an explicit thread URN configured in FastComments before launching the copy.

Blackboard-Specific Gotchas

FastComments tile missing from the Build Content menu (Original) or Content Market (Ultra). The administrator approved the tool but left an institution policy blocking the relevant placement. Go to Administrator Panel > Integrations > LTI Tool Providers, edit the FastComments entry, and confirm both Course Content Tool (Original) and Course Content Tool - allow students / Deep Linking content tool (Ultra) placements are enabled. Save and refresh the course page.

"Tool not configured for this context" or "Tool is not deployed" error on launch. The deployment scope registered during dynamic registration doesn't match the institution context the course belongs to. In Blackboard's tool provider entry, verify the Deployment ID matches what FastComments shows on its LTI 1.3 Configuration page for this tenant. If they differ, delete the placement and re-run dynamic registration from a fresh registration URL (get it here).

Iframe height looks fixed or content gets cut off. Some Blackboard tenants ship with a strict Content Security Policy that blocks the default LTI iframe-resize postMessage. FastComments emits both the Canvas-style lti.frameResize message and the IMS spec-form org.imsglobal.lti.frameResize message to maximize compatibility, but a tenant-level CSP override blocks the parent listener. Ask your administrator to confirm that *.fastcomments.com is on the LTI tool allowlist and that no custom CSP header is stripping postMessage events. Resize then works without further configuration.

Course copy duplicates threads. Blackboard course copy issues new resource link IDs for LTI placements, so copied courses start with empty threads. This is expected. If you need the copied course to inherit the original thread, set up Deep Linking with an explicit thread URN before copying, or contact FastComments support to remap thread IDs in bulk.

Student sees a generic Blackboard error on launch. The cause is a missing or stale email claim. Confirm the institution policy for FastComments has Role, Name, and Email Address enabled under User Fields to Send. Save, then launch again in a fresh browser session.

"Registration token not found, expired, or already used"

The token in your registration URL (get it here) is valid for 30 minutes and can only be used once. If your LMS took longer than that, or if the registration was retried after succeeding, the token will be rejected. Generate a fresh URL in the FastComments LTI 1.3 Configuration page and start over.

"Platform rejected registration"

Your LMS refused the registration handshake. The most common causes:

• Tool already registered with the same client name. Some platforms (notably D2L) reject a second registration of "FastComments" until the previous one is deleted. Remove the old tool in your LMS, then retry.
• Wrong field in the LMS. Make sure you pasted the URL into the registration / tool initiation registration endpoint field, not the launch URL or login URL field.
• The LMS doesn't actually support Dynamic Registration. Older Moodle and Blackboard versions advertise LTI 1.3 but only allow manual configuration. Check your platform's docs.

"Failed to fetch platform configuration"

FastComments was unable to read your LMS's openid-configuration document. This is rare and usually means the LMS provided a malformed or unreachable discovery URL. Contact your LMS support.

Launch shows "Configuration not found"

Either the configuration in FastComments was deleted, or the launch came from an iss/client_id pair we don't recognize. If you deleted and re-registered, instruct your LMS to remove and re-add the FastComments tool so it gets the new client_id.

Launch shows "Deployment not registered"

You launched FastComments from a Brightspace/Moodle/Blackboard deployment different from the one it was first launched in. FastComments pins the deployment_id on first launch as a security check. To add a new deployment under the same client, contact support - we'll add the deployment ID to the configuration.

Launch shows "Unsupported message_type"

The LMS sent an LTI message FastComments doesn't handle (e.g. LtiSubmissionReviewRequest). FastComments supports the standard resource-link launch and deep-linking flows only. Reach out if you need a specific message type added.

Iframe doesn't resize

Most LMSes auto-size LTI iframes. If yours doesn't, check that the LMS's launch settings allow the tool to send postMessage events to the parent frame. FastComments emits both Canvas-style (lti.frameResize) and IMS-spec (org.imsglobal.lti.frameResize) resize messages.