Google Classroom add-ons are now generally available to developers! Please see the
add-ons documentation for more information.
Link Upgrade iframe
Stay organized with collections
Save and categorize content based on your preferences.
The Link Upgrade iframe is the view that teachers see when they agree to
upgrade a Link attachment to an add-on attachment. For additional details about
this feature, see the guide on upgrading links to add-on attachments.
Link Upgrade flow
From the assignment creation page, the teacher can include a link in the Add
link dialog.
Figure 1. The dialog that's displayed on the assignment creation page for a
teacher to create a Link attachment.
If the Link matches a URL pattern that you have provided, the teacher sees a
dialog that prompts them to upgrade the Link to an add-on attachment. If they
agree, the Link Upgrade iframe opens with the relevant iframe query
parameters. Once the attachment has been created, the iframe closes and the
teacher sees the attachment included on the assignment creation page.
See the Recommended user experience section of the guide on upgrading links to
add-on attachments for details on user experience considerations in this flow.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-04-16 UTC.
[null,null,["Last updated 2025-04-16 UTC."],[],[],null,["# Link Upgrade iframe\n\nThe **Link Upgrade iframe** is the view that teachers see when they agree to\nupgrade a Link attachment to an add-on attachment. For additional details about\nthis feature, see the guide on [upgrading links to add-on attachments](/workspace/classroom/add-ons/developer-guides/upgrade-links-to-addons).\n\nLink Upgrade flow\n-----------------\n\nFrom the assignment creation page, the teacher can include a link in the Add\nlink dialog.\n\n**Figure 1.** The dialog that's displayed on the assignment creation page for a\nteacher to create a [Link attachment](/workspace/classroom/reference/rest/v1/Link).\n\nIf the Link matches a [URL pattern](/workspace/classroom/add-ons/developer-guides/upgrade-links-to-addons#configuration_details) that you have provided, the teacher sees a\ndialog that prompts them to upgrade the Link to an add-on attachment. If they\nagree, the Link Upgrade iframe opens with the relevant [iframe query\nparameters](/workspace/classroom/add-ons/developer-guides/iframes). Once the attachment has been created, the iframe closes and the\nteacher sees the attachment included on the assignment creation page.\n\nSee the [Recommended user experience section](/workspace/classroom/add-ons/developer-guides/upgrade-links-to-addons#recommended_user_experience) of the guide on upgrading links to\nadd-on attachments for details on user experience considerations in this flow."]]
