Sharing your project

There are a few different methods to share your MakeCode projects and for places to share your projects to.

Anonymous Share Link

If you are not signed-in to MakeCode, you can create an anonymous link to your project that you can share with others. On the top right, click the Share icon:

Give your project a Title and optionally, you can create a thumbnail image or animated GIF of your project.

Clicking "Share Project" will create a link to your project.

This link is not published anywhere else and it is not tied to a specific user (it’s an "anonymous link"). If you lose the link, then there’s no way to get it back - you will have to share your project again to create a new link. These links are snapshots in time of a project, so if you make any subsequent changes to your project, you will have to Share your project again to create a new link with the changes. There is also no way to remove or "unpublish" an anonymous share link, except through the "Report Abuse" function (see below for more information).

Persistent Share Link

If you sign-in to MakeCode, you can create a persistent share link for your project. This means that you can create one link to a project, share it with others, or include it in curriculum. Then, for any subsequent changes you make to the project, you can keep the same link. For more information on signing in to MakeCode, see Online Accounts and MakeCode.

Persistent share links start with an "S" followed by a series of numbers.

If you want to update or publish changes to a shared project, click to share it again and select the "Update existing share link for this project" checkbox.

Sharing to Google Classroom or Microsoft Teams

As well as being able to share projects to popular social media sites, users can also share their projects to Learning Management Systems (LMS) like Google Classroom or Microsoft Teams. In the Share Project window, click on the appropriate icon and you will be prompted to sign into the LMS and select where you want to share to.

Sharing to Mobile devices

For sharing projects to phones or other mobile devices, you can use your device’s camera to capture the QR code in the Share Project window.

Embedding into a blog or web site

MakeCode projects can also be embedded into a blog or web site. In the Share Project window, click on the Embed icon and copy/paste the HTML content. You can choose to embed just the project code, a read-only view of the editor, or just the simulator part of the project.

Editing Shared Projects

By default, all shared projects in MakeCode can be copied and edited. There is no way to share a read-only project, or a project where people can’t make a copy or can’t see the code. Any edits they make will not change the original project - if they want to share their changes back, they will have to create a new share link.

Asset Packs

Certain editors (such as MakeCode Arcade) can include resource files inside of projects. The resources, or assets, might contain byte representations of images, animations, sounds, tilemaps, etc. An Asset Pack is a resource only project where just the assets are shared and no code is loaded from the shared project.

If this feature is supported by your editor, you can set a project as an asset pack by going to the Settings (⚙️) menu and selecting 'Project Settings'. Enable the 'Import as asset pack' setting. Watch this video to see how it's done:

See the Asset Packs page to learn more.

Report Abuse

All MakeCode shared projects pass through Microsoft standard scanning for security and safety compliance. In addition, the "Report Abuse" option is available on any shared project if you deem the contents of the project not appropriate (contains unsafe content or includes personally identifiable information). For these types of projects, the MakeCode Team will remove the project from our databases.

Edit this page on GitHub
Edit template of this page on GitHub
Edit template of this page on GitHub