Stay organized with collections
Save and categorize content based on your preferences.
There may be some situations in which you would prefer users interact with your
product outside of an iframe. You can load attachment content in a new tab
rather than in a Classroom add-on iframe as long as your
add-on conforms to the following guidelines.
Required behaviors in new tabs or windows
The Classroom add-on requirements checklist specifies certain
behaviors when opening new tabs or windows. The following table provides
clarifications and implementation suggestions regarding each requirement.
ID
Requirement
How to meet
3.2
If a task is launched into a new
tab or window from any of the
iframe journeys, it MUST provide
a user-friendly message to
return to
Classroom.
On the external site, include a
message, banner, toast, or other
notification instructing the
user to return to
Classroom when
finished with the task.
5.1
When the studentViewUri is
launched, the
add-on
SHOULD NOT pop the user out of
the iframe to complete a task.
Ideally, users are able to
complete all relevant journeys
within the iframe. Opening new
tabs can disorient users and
adds to the complexity of using
the
add-on.
Keep the user experience within
the iframe to provide the least
user friction.
5.2
If the
add-on
activity pops out of the iframe
there MUST be a preview about
the task in the iframe.
Don't open the external site
immediately when the user clicks
the attachment card. Instead,
provide a basic interstitial
view in the iframe showing an
image or description of the task
that opens in a new tab. Include
instructions to help users
successfully navigate and
complete the activity.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Open content in new tabs\n\nThere may be some situations in which you would prefer users interact with your\nproduct outside of an iframe. You can load attachment content in a new tab\nrather than in a Classroom add-on iframe as long as your\nadd-on conforms to the following guidelines.\n| **Important:** You should adapt your content to work within the iframes if possible. Ease of access and reduced time and effort to reach content are two key benefits of building a Classroom add-on.\n\nRequired behaviors in new tabs or windows\n-----------------------------------------\n\nThe Classroom add-on [requirements checklist](/workspace/classroom/add-ons/requirements) specifies certain\nbehaviors when opening new tabs or windows. The following table provides\nclarifications and implementation suggestions regarding each requirement.\n\n| ID | Requirement | How to meet |\n|-----|-------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 3.2 | If a task is launched into a new tab or window from any of the iframe journeys, it MUST provide a user-friendly message to return to Classroom. | On the external site, include a message, banner, toast, or other notification instructing the user to return to Classroom when finished with the task. |\n| 5.1 | When the `studentViewUri` is launched, the add-on SHOULD NOT pop the user out of the iframe to complete a task. | Ideally, users are able to complete all relevant journeys within the iframe. Opening new tabs can disorient users and adds to the complexity of using the add-on. Keep the user experience within the iframe to provide the least user friction. |\n| 5.2 | If the add-on activity pops out of the iframe there MUST be a preview about the task in the iframe. | Don't open the external site immediately when the user clicks the attachment card. Instead, provide a basic interstitial view in the iframe showing an image or description of the task that opens in a new tab. Include instructions to help users successfully navigate and complete the activity. |"]]
