Skip to main content
All CollectionsSelf-Paced ContentCodelabs
How to import Codelabs to PlusPlus
How to import Codelabs to PlusPlus

Learn how to import and publish a new Codelab or a new version of a Codelab to PlusPlus.

Chris Ramlow avatar
Written by Chris Ramlow
Updated over a week ago

As an admin, organizer, or content owner, you have a technical tutorial you want to import to PlusPlus as a Codelab. This can be a new Codelab or an updated version of an existing one.


Import the tutorial using the steps below.
But first, make sure you have Codelabs enabled in your instance of PlusPlus.

  1. Prepare your Codelab content in one of the following ways:

    Learn more about authoring Google Codelabs.

  2. In your PlusPlus Catalog, click New and select Codelab from the menu.
    Note that you may need to enable Codelab first at Settings > Site > Supported content types.

    If you want to import a new version of an existing Codelab, access the Codelab in PlusPlus, open the context menu (button with three dots), and select Import new version.

    The Import new Codelab (or Import new Codelab version) dialog opens.

  3. For a Markdown (ZIP) Codelab, click Select a ZIP file.
    Your file explorer opens.

    For a Codelab authored in Google Docs, click Select a Google Doc.
    The Select a file dialog opens for Google Docs. (You may have to sign in with your Google account first.)

  4. Select the Codelabfile (zipped or Google Doc) you want to import.

  5. Click Import.
    A dialog opens showing import progress until completion, and you are navigated to the Edit Codelab page for the new Codelab. (Or, if updating a Codelab with a new version, you are navigated back to the Codelabs landing page, and the process is complete).

  6. Update the Codelab as needed.
    Note that the system automatically attempts to set the Codelabs name, description, duration, and tags, based on metadata included in the Codelab file.

    The person who imports the file is added as the Codelab Maintainer by default.

    You can also set the Codelab as inline if you only want it to be visible in tracks to which it is added.

  7. Click Save.
    The new Codelab is added to the Catalog and is discoverable for engineers.

Go deeper

Google Drive integration

To turn on the Google Drive integration, go to Settings > Integrations > Storage and turn on Enable Google Drive integration. Be sure to Save your settings, too.

Zipping your codelab files

The zipped Google Codelab-formatted Markdown file you create should contain the Codelab Markdown (.md) file, plus any assets, but avoid other files or folder structures. The import tool picks up the first .md file in the zip file that is not

The formatting for authoring in Google Codelabs is familiar to engineers, and PlusPlus can use the metadata defined in a Markdown file to build out Codelab details upon import.

The option to import Codelabs authored in Google Docs does not require the zipping process.

Are users already in a codelab able to see the updated version?

Once learners launch a Codelab, they remain on the same version of the Codelab until completion, even if you add a new version of the Codelab while they are still engaging it. To engage the new version, learners already in the Codelab must drop their assignment to the Codelab and launch again. However, we are soon to release a feature that allows learners to choose whether to Relaunch the Codelab with the latest version or to Continue their progress with the previous version.

Managing and tracking Codelab assignments

You can see who has been assigned to a Codelab and how far they've gotten through it, and you can update their assignment in various ways. Learn more.

See also

Did this answer your question?