on Received String

Run part of a program when the micro:bit receives a string over radio.

radio.onReceivedString(function (receivedString) {})


  • receivedString: The string that was sent in this packet or the empty string if this packet did not contain a string. See send string and send value

Watch this video to see how the radio hardware works on the micro:bit:


This program continuously sends a cheerful message. It also receives a messages from nearby micro:bits. It shows these messages on the screen.

basic.forever(() => {
    radio.sendString("I'm happy");
radio.onReceivedString(function (receivedString) {


The ||radio:on received string|| event can only be created once, due to the hardware restrictions.

The radio set group might need to be set, synchronized, before the radio events will function.

See also

on received number, received packet, send number, send string, send value, set group