This is an FAQ and troubleshooting guide for various LTI-integration scenarios. We will continue updating this document as we receive new questions from instructors and administrators. Since we cannot control changes made by Learning Management Systems or predict the effects of certain institutional customizations, we cannot guarantee that our answers are correct for all users or that our answers won't change over time. When in doubt, reach out to us at email@example.com.
When I try to integrate Yellowdig with Blackboard Learn, I don't see an option that says "This link is to a tool provider". Why is this happening, and how do I fix it?
First off, make sure that you've entered https://api.yellowdig.app/launch into the URL field first. The option will not display until you've entered the URL.
If you still don't see this option, it's likely because LTI tools are not enabled in your Blackboard course. To enable LTI, navigate to Customization → Tool Availability. Then scroll down to "LTI" and check the box in the "Available" column. Finally, click the SUBMIT button.
Why am I receiving a confusing error message when I click on my Yellowdig launch link in Blackboard Learn?
Yellowdig authenticates users on the basis of an email parameter that is passed from your LMS to Yellowdig. In Blackboard, administrators determine whether or not Blackboard sends users' emails to LTI tools. To integrate Yellowdig with Blackboard, email passthrough must be turned on. To have passthrough turned on for your institution, contact your Learning Management Administrator. If you don't know who your institution's Learning Management Administrator is, contact us and we'll reach out on your behalf. If you are an administrator, follow these instructions (item (4) under the heading "Configure LTI tool providers global properties") to enable email passthrough for your organization.
I edited and/or copy-pasted my Canvas XML code during integration, and now my Canvas interface is wonky. What happened?
You likely changed your XML code in ways that are creating instability in the integration. Even if you simply copy-pasted your XML code, unseen HTML elements can cause problems behind the scenes. Unless you are a power user, we strongly recommend that you configure by URL, not by pasting the XML. Even if your institution provides an official custom XML, you should always copy-paste the URL that links to the XML code; do not copy-paste the code itself. When in doubt, simply follow our instructions to the letter.
On the left side of my Community page, I'm seeing a "grading not configured" message. What's going on, and how do I fix it?
If you're the Community Owner, this means that grade passback has not yet been set up for your students. If you're a Community Member, this means that grade passback has not yet been set up for you personally. In Canvas, the solution to the problem is to click on the Assignments link for Yellowdig at least once. After that, you can use the sidebar link in Canvas to enter Yellowdig, but to initially set up grade passback, the instructor must click the Assignment link, and each student must do the same.
If you are experiencing this problem as a Blackboard user, check to see whether there are multiple links to Yellowdig. It is possible that, due to the instructor's Blackboard assignment settings, only one of these assignment links enables grade passback. In that case, students must click that assignment link to enable grade passback. Because this can create confusion for students, we strongly recommend that Community Owners create only one LMS link to their Yellowdig Community. We do not recommend links for each week (e.g., "Yellowdig - Week 2", "Yellowdig - Week 3").
I heard that students can enable grade passback in Canvas without ever clicking the Yellowdig link in "Assignments", but it isn't working for my students. How do I enable this feature?
This requires special configuration with our Canvas Developer API. To set up this configuration for your institution, contact us at firstname.lastname@example.org. If you are not an administrator, make sure that you have rightful access to the Canvas Developer API.
As a Brightspace user, I am encountering iFrame limitations when integrating Yellowdig. What should I do?
When you configure Yellowdig via External Learning Tools (under Admin Tools), be sure to check the box next to "Open as External Resource" (under Edit Properties In-place).