Knowledge Base.

Bluetooth Troubleshooting in the Classroom

You are here:

Running into issues using your Bluetooth Hat or classic Bluetooth Cubelet in a classroom or multi-user environment? We’ve got some troubleshooting tips to help get things back on track!

Prepping before class can cut down on Cubelets chaos. Be sure to check out our #CubeletsChat blog post, Preparing for Bluetooth in the Classroom for tested tips and tricks on prep and classroom management when using the Bluetooth Hat or Bluetooth Cubelet.

If you don’t find a solution here, our stellar support team is available at and will respond within one business day (and often much faster!).

Troubleshooting applicable to both the Bluetooth Hat and classic Bluetooth Cubelet

  • Both the Bluetooth Hat and Bluetooth Cubelet have a multicolor LED for pairing and troubleshooting.

3-Color Identifying Sequence – blinks a few times when powered on. Used for pairing to Cubelets Blockly and for pairing the Bluetooth Cubelet to apps (For example: blinks Red-Green-Blue – ‘Cubelet RGB’)
Blinking Green Light – searching for a device
Blinking Blue Light – successfully paired to a device
Solid Red Light – software issue; detach, wait a few seconds, and re-attach
Solid White Light – software issue, contact

  • App/Hardware compatibility

Our web-app, Cubelets Console, is only compatible with the Bluetooth Hat. The legacy application, Cubelets Flash, is only compatible with the classic Bluetooth Cubelet (check out the C Coding feature in Console!). Please contact us at if you’d like to upgrade from the classic Bluetooth Cubelet to the Bluetooth Hat.

  • Is all of your software up to date?

This includes the operating system on your devices and the Cubelets App. Cubelets applications are optimized to work with the latest operating systems releases for iOS, Android, FireOS, Mac, Windows, and Chrome OS. Out of date software on your device can cause all sorts of bugs, including Cubelets that don’t show up in the Block Map and application crashes.

  • Are WiFi network restrictions preventing you from programming?

Schools often have restrictions on their WiFi network that can prevent Cubelets Console or the Cubelets app from connecting to our compiler for programming. The same restrictions can sometimes also prevent updates to the apps. This is the most common issue we see that prevents our apps from working in schools or government buildings. If you are able to pair to your Bluetooth Hat through the app or Cubelets Console but are not able to re-program or successfully use the Personality Swap feature, your school or business may have a firewall that restricts some websites. If you’re unsure if network restrictions are the issue, please try programming or using Personality Swap on your home WiFi or on a public WiFi. To bypass a restricted network, pass this document to your IT team so they can whitelist the sites necessary for Cubelets Console and the Cubelets App.

Troubleshooting the Bluetooth Hat

  • Cubelets App pairing to the wrong device – multiple Hats in close proximity

When working with multiple Bluetooth Hats in the same room, there is a possibility for confusion if everyone pairs simultaneously. Because the Hat works with BLE location-based pairing, it is possible for another device to pair to your intended Hat if both devices have the Cubelets app open in pairing mode and are near your robot construction.

Tips to prevent this:

  1.  Take turns pairing if you’re sitting at the same table or close proximity.
  2.  Avoid disconnections by snapping the Hat onto the Battery Cubelet so you can alter your robot without needing to pair again.
  3.  If your device is paired and the app takes you to the Cubelets Map, but your Bluetooth Hat is flashing green, your device has paired to a different Hat. The Bluetooth Hat will blink Blue when successfully paired. Close the Cubelets App, re-open, and try to pair again one at a time.
  • Did you agree to Location Permissions?

If you’re using an Android or FireOS device with the Cubelets App, you will need to agree to location permissions for the app to work. Read more about this in our FAQ article here.

Troubleshooting for the classic Bluetooth Cubelet

  • iOS auto-pairing feature

The most common issue when using the classic Bluetooth Cubelet on the iOS platform is the auto-pairing feature. iOS devices will automatically pair with familiar Bluetooth accessories by default, so if you have previously paired your Bluetooth “Cubelet – CRM” to your iPad, and then try to pair the Cubelet – CRM to your iPhone while the iPad has the Bluetooth setting switch ‘on’ and is close by, Cubelet – CRM will pair to the iPad before you can pair to the unfamiliar device.

Tips to prevent iOS auto-pairing in the classroom:

  1. Couple specific Bluetooth Cubelets to specific devices so that the same device is always used with the same Bluetooth Cubelet.
  2. At the conclusion of each class, have your students remove the Bluetooth Cubelet from the “My Devices” list in the Bluetooth Settings. You can find your Bluetooth Cubelet in the Bluetooth Settings using the unique 3 color sequence, for example, “Cubelet – CRM”. Select the little info icon to the right and select “forget this device”.
  • Avoiding classic Bluetooth Cubelet disconnects

If power is lost to the classic Bluetooth Cubelet, then you will need to re-pair in your device’s Bluetooth Settings. Make sure all of your Cubelet’s magnetic connecting faces are clean for a good connection. You can find Cubelets Maintenance Tips here!

Since the Bluetooth Cubelet is powered by the Battery Cubelet, it is important that the Battery not be turned off, bumped or disconnected during programming. To prevent unintentional disconnects, some teachers will tape together the Battery and classic Bluetooth Cubelet. Let students know that any Cubelets they wish to reprogram must be connected to a block face of the Bluetooth Cubelet for flashing.

Is your Bluetooth Hat or Cubelet still giving you trouble! Please contact us at We’d love to help!

Previous Bluetooth Troubleshooting at Home
Next Cubelets Maintenance
Table of Contents


Frequently asked questions.

Cubelets FAQs is your place to find answers to common questions about Cubelets robot blocks, orders, and Modular Robotics.

Contact us.

Need help, can't find an answer? Contact the Modular Robotics support team and we'll help you!

Shipping and tax policies.

Get the details on Modular Robotics shipping policies and sales tax collection for orders in the United States and around the world.

Warranty and returns.

Cubelets are backed by a one year warranty. Need to make a claim, get a replacement, or have questions? Click to get started.

Cubelets Resources.

Everything you need to teach with Cubelets robot blocks.

Explore a huge collection of K-12 lessons, activities, guides, training, and more.

New to Cubelets?

Learn everything you need to know to start creating more with Cubelets robot blocks in this handy Getting Started Guide.

Go further with Cubelets apps.

Go beyond the building blocks and play with the code inside. Cubelets apps make it easy to create even more with your Cubelets.

Looking for some inspiration?

There are millions of robots you can create with Cubelets. Check out these robots to help inspire your inventions.

Shop Cubelets.


Cubelets robot blocks are used by educators all around the world to help students explore computational thinking, coding, and STEM. 

Jump to...

At Home.

Bring home the educational teaching tool loved by teachers everywhere. Explore sets designed for learning through play.

Jump to...