# Tutorial Help - "Please check your internet connection and check the tutorial is valid."

**URL:** <https://forum.makecode.com/t/tutorial-help-please-check-your-internet-connection-and-check-the-tutorial-is-valid/9178>\
**Category:** micro:bit\
**Created:** [July 12, 2021, 3:19pm UTC](https://forum.makecode.com/t/tutorial-help-please-check-your-internet-connection-and-check-the-tutorial-is-valid/9178 "2021-07-12T15:19:37Z")\
**Posts on this page:** 16\
**Page:** 1

<div class="post-metadata">

**Author:** ![CherylNg](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/cherylng/32/4552_2.png) [@CherylNg](https://forum.makecode.com/u/CherylNg)\
**Post date:** [July 12, 2021, 3:19pm UTC](https://forum.makecode.com/t/tutorial-help-please-check-your-internet-connection-and-check-the-tutorial-is-valid/9178/1 "2021-07-12T15:19:37Z")

</div>

Hi,

I followed the steps in this video [MakeCode for micro:bit - Creating Tutorials](https://www.youtube.com/watch?v=R-kY-dQXZvA) to create a tutorial. When I clicked RUN on the Tutorial Tool, I got this error message - “Oops, an error occurred as we were loading the tutorial”.

 ![image](https://us1.discourse-cdn.com/flex020/uploads/makecode/original/2X/6/6fc147bcab1952a0e43d6076d35b665ad6341483.png)

I also tried using GitHub-MakeCode Editor and received the same error message when I tried to load the tutorial using the shared link.

And when I clicked Preview in MakeCode Editor, I got this message - “Please check your internet connection and check the tutorial is valid.”

 ![image](https://us1.discourse-cdn.com/flex020/uploads/makecode/original/2X/f/f706e1b5701d603f673593a629c0b5211e9e8e0f.jpeg)

My internet connection was okay. I’ve tried to open using an incognito window and also tried to open using another browser. And I’ve also tried signing out from GitHub.

What could be the problem? How to check whether a tutorial is “valid”?  
Appreciate some pointers to move forward. Thanks in advance.

Cheers,  
Cheryl

---

<div class="post-metadata">

**Author:** ![shakao](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/shakao/32/113_2.png) [@shakao](https://forum.makecode.com/u/shakao)\
**Post date:** [July 12, 2021, 3:21pm UTC](https://forum.makecode.com/t/tutorial-help-please-check-your-internet-connection-and-check-the-tutorial-is-valid/9178/2 "2021-07-12T15:21:30Z")

</div>

Hmm, could you post the markdown/text of your tutorial? Our error messages unfortunately aren’t great, but usually this means something in the tutorial was formatted in a way that we couldn’t gracefully handle and the project crashes/errors out instead.

---

<div class="post-metadata">

**Author:** ![CherylNg](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/cherylng/32/4552_2.png) [@CherylNg](https://forum.makecode.com/u/CherylNg)\
**Post date:** [July 13, 2021, 4:28pm UTC](https://forum.makecode.com/t/tutorial-help-please-check-your-internet-connection-and-check-the-tutorial-is-valid/9178/3 "2021-07-13T16:28:18Z")

</div>

Hi, thanks for your response.

I managed to get the shared [link](https://makecode.microbit.org/#tutorial:github:cherylng/test_tutorial/tutorial) to work after I corrected a formatting error. My mistake there.

The preview is still not working though. Still getting the same error message - “Please check your internet connection and check the tutorial is valid.”

Here’s the URL link to the markdown -[https://github.com/CherylNg/test\_tutorial/blob/master/tutorial.md](https://github.com/CherylNg/test_tutorial/blob/master/tutorial.md)

This is my first attempt at writing a tutorial. Do point out if I’m doing anything wrong here. Thanks for your help.

Cheers,  
Cheryl

---

<div class="post-metadata">

**Author:** ![shakao](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/shakao/32/113_2.png) [@shakao](https://forum.makecode.com/u/shakao)\
**Post date:** [July 13, 2021, 4:34pm UTC](https://forum.makecode.com/t/tutorial-help-please-check-your-internet-connection-and-check-the-tutorial-is-valid/9178/4 "2021-07-13T16:34:31Z")

</div>

Oh! Your tutorial loads for me! Try it in an incognito browser window, or refresh your entire page and load the tutorial again? Sometimes the embedded editor can get into a bad state–basically the same as if the page crashed.

---

<div class="post-metadata">

**Author:** ![halspeed](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/halspeed/32/3848_2.png) [@halspeed](https://forum.makecode.com/u/halspeed)\
**Post date:** [July 14, 2021, 12:32am UTC](https://forum.makecode.com/t/tutorial-help-please-check-your-internet-connection-and-check-the-tutorial-is-valid/9178/5 "2021-07-14T00:32:58Z")

</div>

@jwunderl is anyone else having problems loading tutorials in micro:bit 4.0.9? Kid Spark Education is putting our entire curriculum in the MakeCode tutorials, and I’d like to feel confident that it’s stable.

---

<div class="post-metadata">

**Author:** ![halspeed](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/halspeed/32/3848_2.png) [@halspeed](https://forum.makecode.com/u/halspeed)\
**Post date:** [July 14, 2021, 12:33am UTC](https://forum.makecode.com/t/tutorial-help-please-check-your-internet-connection-and-check-the-tutorial-is-valid/9178/6 "2021-07-14T00:33:01Z")

</div>

I’ve been having lots of issues with tutorials today. Even the default example in the tutorial tool will not load, but it does load for the other targets.

---

<div class="post-metadata">

**Author:** ![jwunderl](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/jwunderl/32/5308_2.png) [@jwunderl](https://forum.makecode.com/u/jwunderl)\
**Post date:** [July 14, 2021, 1:04am UTC](https://forum.makecode.com/t/tutorial-help-please-check-your-internet-connection-and-check-the-tutorial-is-valid/9178/7 "2021-07-14T01:04:34Z")

</div>

Hm first I’ve seen it but yeah, it looks like there’s something broken with loading tutorials when opening tutorials that have no code snippets – e.g.

````auto
# My Tutorial

## Step 1

Here is some text.

```blocks
let a = "a"
```

## Step 2

Congratulations, you did it!

````

Works fine but

```auto
# My Tutorial

## Step 1

Here is some text.

## Step 2

Congratulations, you did it!

```

is broken (specifically, it errors out while identifying used blocks).

We’ll fix though~ (@shakao for reference, I’ll take a look real quick since I have an easy repro)

---

<div class="post-metadata">

**Author:** ![halspeed](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/halspeed/32/3848_2.png) [@halspeed](https://forum.makecode.com/u/halspeed)\
**Post date:** [July 14, 2021, 4:44am UTC](https://forum.makecode.com/t/tutorial-help-please-check-your-internet-connection-and-check-the-tutorial-is-valid/9178/8 "2021-07-14T04:44:50Z")

</div>

Also is there a way to use images in tutorials that are stored in the github repo of the tutorial author?

/docs/static in the documentation is for pxt-microbit/docs/static

Other authors have used their own web server outside of the github tutorial repo as a workaround, but it would be nice is the images could be stored in the same repo as the tutorial md file.

---

<div class="post-metadata">

**Author:** ![jwunderl](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/jwunderl/32/5308_2.png) [@jwunderl](https://forum.makecode.com/u/jwunderl)\
**Post date:** [July 14, 2021, 4:49am UTC](https://forum.makecode.com/t/tutorial-help-please-check-your-internet-connection-and-check-the-tutorial-is-valid/9178/9 "2021-07-14T04:49:00Z")

</div>

I haven’t personally attempted using an image in an external tutorial in a while so I can’t confirm immediately, but if loading in an image from external site currently works then they can just be stored in the repo itself; all the files on github get stored under githubusercontent e.g.  
`https://raw.githubusercontent.com/microsoft/pxt-microbit/master/docs/static/v2/back.jpg`

[![](https://raw.githubusercontent.com/microsoft/pxt-microbit/master/docs/static/v2/back.jpg) ](https://raw.githubusercontent.com/microsoft/pxt-microbit/master/docs/static/v2/back.jpg)

is the place that the image [https://github.com/microsoft/pxt-microbit/blob/master/docs/static/v2/back.jpg](https://github.com/microsoft/pxt-microbit/blob/master/docs/static/v2/back.jpg) is stored. It’s easy to create the link if you have the github link by just comparing the two, but you can also right click → copy image address to get it easily:

![image](https://us1.discourse-cdn.com/flex020/uploads/makecode/original/2X/8/82d5e54ac960dca4698b358644ff8f4a5d620cb3.png)

and going to the link (it has a different one by default that redirects, either should be fine: `https://github.com/microsoft/pxt-microbit/blob/master/docs/static/v2/back.jpg?raw=true`)

---

<div class="post-metadata">

**Author:** ![halspeed](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/halspeed/32/3848_2.png) [@halspeed](https://forum.makecode.com/u/halspeed)\
**Post date:** [July 14, 2021, 4:28pm UTC](https://forum.makecode.com/t/tutorial-help-please-check-your-internet-connection-and-check-the-tutorial-is-valid/9178/10 "2021-07-14T16:28:27Z")

</div>

Thanks @jwunderl that’s so obvious now that you say it! Yes, it works fine.

---

<div class="post-metadata">

**Author:** ![shakao](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/shakao/32/113_2.png) [@shakao](https://forum.makecode.com/u/shakao)\
**Post date:** [July 14, 2021, 4:31pm UTC](https://forum.makecode.com/t/tutorial-help-please-check-your-internet-connection-and-check-the-tutorial-is-valid/9178/11 "2021-07-14T16:31:17Z")

</div>

Hm, we haven’t had many reports of tutorial instability (the same tutorial sometimes loading and not loading), if you have specific tutorials where you’ve been seeing this behavior it would be great if you could link the markdown files. Additionally, if you have what browser it was being loaded on that would be super helpful!

---

<div class="post-metadata">

**Author:** ![halspeed](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/halspeed/32/3848_2.png) [@halspeed](https://forum.makecode.com/u/halspeed)\
**Post date:** [July 15, 2021, 4:53am UTC](https://forum.makecode.com/t/tutorial-help-please-check-your-internet-connection-and-check-the-tutorial-is-valid/9178/12 "2021-07-15T04:53:37Z")

</div>

@shakao it’s mainly been around loading the tutorial. Once it loads, I usually don’t have any problems.

I noticed a new problem tonight that sometimes my embedded text for `||advanced:Advanced||` and `||serial:Serial||` don’t show in the correct color. Yet, they show correctly in the side-panel preview.

---

<div class="post-metadata">

**Author:** ![shakao](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/shakao/32/113_2.png) [@shakao](https://forum.makecode.com/u/shakao)\
**Post date:** [July 16, 2021, 4:24pm UTC](https://forum.makecode.com/t/tutorial-help-please-check-your-internet-connection-and-check-the-tutorial-is-valid/9178/13 "2021-07-16T16:24:40Z")

</div>

Do you have a link to the tutorial files where you’re seeing the issue? We can take a look! “Advanced” won’t be colored correctly since it’s an expanding drawer and not a “real” toolbox category–this is probably a feature we should add, I’ll make a note of it.

---

<div class="post-metadata">

**Author:** ![halspeed](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/halspeed/32/3848_2.png) [@halspeed](https://forum.makecode.com/u/halspeed)\
**Post date:** [July 19, 2021, 4:01pm UTC](https://forum.makecode.com/t/tutorial-help-please-check-your-internet-connection-and-check-the-tutorial-is-valid/9178/14 "2021-07-19T16:01:18Z")

</div>

@shakao There doesn’t seem to be any consistency to the loading problems…sometimes they load, somethings they don’t. But it could also be local cache and some of the revision changes during the beta updates (see [post 8364](https://forum.makecode.com/t/tutorial-extension-block-does-not-show-in-tool-drawer/8364)).

Now that 2021 is released, the only load problem has been the tutorial without the code snippets discussed above.

The repo is here if you want to take a look: [https://github.com/KidSpark/tutorials](https://github.com/KidSpark/tutorials)

We haven’t pushed these to classrooms yet, so it’s only been internal testing. We also plan to submit these for approval in the event you want to approve them now 🙂

---

<div class="post-metadata">

**Author:** ![Amy](https://avatars.discourse-cdn.com/v4/letter/a/4da419/32.png) [@Amy](https://forum.makecode.com/u/Amy)\
**Post date:** [August 19, 2021, 7:19am UTC](https://forum.makecode.com/t/tutorial-help-please-check-your-internet-connection-and-check-the-tutorial-is-valid/9178/15 "2021-08-19T07:19:21Z")

</div>

I am using version 4.0.11 of microbit makecode and version 7.0.8 of makecode. I am getting that ‘oops’ error message when trying to run the sample program in the tutorial builder. This is my first time working with it.

---

<div class="post-metadata">

**Author:** ![halspeed](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/halspeed/32/3848_2.png) [@halspeed](https://forum.makecode.com/u/halspeed)\
**Post date:** [August 24, 2021, 5:50pm UTC](https://forum.makecode.com/t/tutorial-help-please-check-your-internet-connection-and-check-the-tutorial-is-valid/9178/16 "2021-08-24T17:50:51Z")

</div>

@jwunderl Any update on fixing the tutorial loading without code snippets? FYI, I filed at issue here:

> <https://github.com/microsoft/pxt-microbit/issues/4340>
>
> See forum post: https://forum.makecode.com/t/tutorial-help-please-check-your-int…ernet-connection-and-check-the-tutorial-is-valid/9178
> 
> Tutorials without sample code fail to load.
