---
title: "Troubleshooting H5P"
slug: "troubleshooting-h5p"
updated: 2026-08-13T16:01:17Z
published: 2026-08-13T16:01:17Z
canonical: "totara.help/troubleshooting-h5p"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://totara.help/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting H5P

There maybe cases where Site Administrators or Course Creators come across common **H5P** errors, specifically:

- Validation errors related to missing H5P libraries
- Errors relating to a missing site UUID or Hub secret

## Resolving H5P errors

### **Error: Validating H5P package failed: Missing main library @library**

This error usually occurs when attempting to upload H5P content that relies on a content type library that is not currently installed on the site.

![](https://cdn.document360.io/a007399b-031e-436b-999a-528240e16f58/Images/Documentation/image-1747994438944.png?sv=2026-02-06&spr=https&st=2026-11-06T06%3A17%3A19Z&se=2026-11-06T07%3A17%3A19Z&sr=c&sp=r&sig=uTOwCrEFJR0mea7n81FglPPFQIHZGtm64pl3IBaifVw%3D)

#### **Causes**

The most common cause is the absence of the required H5P library for the content type in use.

#### **Resolutions**

Try one of the following solutions:

**Install the required content type via a course activity**

1. Go to any course.
2. Add a new [H5P activity](/totara-20/docs/create-an-h5p-activity).
3. Select the content type matching the one used in the file you are attempting to upload.
4. The system will prompt you to install the missing library if not already installed.
5. Once installed, return to the original location and try the upload again.

**Check for existing library updates**

1. Navigate to Q*uick-access menu > Plugins > Activity modules > H5P > H5P Libraries.*
2. Select the **Update** button (![](https://cdn.document360.io/a007399b-031e-436b-999a-528240e16f58/Images/Documentation/image-1747994347335.png?sv=2026-02-06&spr=https&st=2026-11-06T06%3A17%3A19Z&se=2026-11-06T07%3A17%3A19Z&sr=c&sp=r&sig=uTOwCrEFJR0mea7n81FglPPFQIHZGtm64pl3IBaifVw%3D)) beside the relevant library.
  - If active, click to update.
  - If greyed out, the library is up to date.

**Manually update through an activity**

If an older version of a content type exists and cannot be updated directly:

1. Add a new [H5P activity](/totara-20/docs/create-an-h5p-activity) in a course.
2. Select the same content type as the file you wish to upload.
3. If an **Update available** notice is shown, click it to update the content type and associated libraries.
4. Retry the file upload afterward.

### **Error: Missing Site UUID or Hub Secret. Please check your Hub registration.**

This is a known issue with the H5P framework and is not specific to Totara.

#### **Explanation**

The error may appear during testing or in development environments, and the error message would be shown on the H5P libraries page (*Quick-access menu > Plugins > Activity modules > H5P > H5P libraries*). It relates to the H5P Hub functionality, which requires a valid UUID and secret key.

![](https://cdn.document360.io/a007399b-031e-436b-999a-528240e16f58/Images/Documentation/image-1747994514029.png?sv=2026-02-06&spr=https&st=2026-11-06T06%3A17%3A19Z&se=2026-11-06T07%3A17%3A19Z&sr=c&sp=r&sig=uTOwCrEFJR0mea7n81FglPPFQIHZGtm64pl3IBaifVw%3D)

#### **Impact**

- **Does not affect learners** – This error message is only visible to Site Administrators and Course Creators.
- **No action required for most users** – If content is functioning correctly otherwise, the warning can be safely ignored.

There have been multiple attempts to resolve this bug within H5P, but as of now, no long-term fix has been released by the H5P developers.

To resolve the error click on **Update content type cache.**

Note, the **Missing Site UUID or Hub Secret. Please check your Hub registration** error message may return when revisiting the H5P Libraries page. Select **Update content type cache** to clear the error message.

Join the [Totara Community](https://totara.community/) for more resources to help you get the most out of Totara.

© Copyright 2026 Totara Learning Solutions. All rights reserved.