Documentation & Help

How can we help you?

Flat integration (LTI)
Flat for Education is designed to empower music learning and teaching for students as well as educators around the world.

Through our easy-to-use, yet powerful cloud-based music notation platform, our mission is to develop students’ music theory, composition, and performance knowledge in an engaging and educational way.

Flat for Education provides teachers the tools they need to boost classroom creativity while helping manage their classroom by allowing them to easily track their student’s engagement with each assignment, their work, progress, and outcomes.

✓ Private and dedicated workspace for your school
✓ Web-based music notation software with real-time collaboration
✓ Google Classroom and Google Drive synchronization
✓ Classes and assignments features to create stunning activities in your music classes
✓ Compose with your MIDI devices: plug your device and play!
✓ MusicXML, PDF and Audio (MP3 and WAV) compatible
✓ Read and write music notation and guitar tablatures, together
✓ Smart History: Browse all the modifications you made, note after note
✓ Collaborate with video within Google Hangouts
✓ Percussion instruments and notation to create amazing drum scores
✓ Online digital and visual metronome to help you to practice easily

From, go to Integrations and select LTI, by clicking "+ Link".

From the next screen, save the details required to connect with Xen.Ed:
  • LTI Launch URL
  • Consumer Key
  • Shared Secret / Consumer Secret

These pieces of information combined form what is known as an LTI "passport"

Please note: These values should be your own and be kept safe to avoid giving anyone access to your learner data!

4. Adding your LTI passport to your Xen.Ed course

Navigate to your course's Advanced Settings and scroll down or search the page to find the LTI Consumer Passports field.

The passport must entered in the format: "id:client_key:client_secret". The quotes are important:
  1. The ID is what we use to tell Xen.Ed what key to use. In this case we'll use flat as our ID, so that you can easily identify it later, especially if you setup several LTIs.

  2. The client_key is the Consumer Key from

  3. The client_secret is the Shared Secret / Consumer Secret from
When put together, it should look like this:

5. Insert your content using the LTI Consumer component

Now that you have an LTI passport set up, the final thing we need to do is insert Flat into your course. 

First, make sure to enable the component from your Admin/configuration panel. Make sure "LTI Consumer" is available in the list on the right.

Once this is enabled, navigate to the page where you want to insert the Flat activity. Under Advanced, select LTI Consumer.

From the newly dropped component, select Edit. and set your Display Name to a name that matches your activity.

Then fill the URL field with the LTI Launch URL value from

If your content is a problem that you want to grade, ensure that you set Scored to True and give it a Weight of however many points you want the question to be worth. 

Note that this is useful even if the subsection isn't graded, as the learner's practice scores will still pull through to let them see that they've completed the activity and give the learner the satisfaction of seeing a correct score recorded.

Lastly, but most importantly, set Send Extra Parameters to True
This will send details like the learner's email address across to Flat and allow their progress to be saved and recalled.

Was this article helpful?