Help understand and fix "Error loading form. please try again or check with an administrator"

When I create new contacts on this user’s device, I’m seeing the error “Error loading form. please try again or check with an administrator”

  1. The user’s device was fully synced.
  2. If I logged in as this user on a fresh device, I was able to create contacts without error.
  3. There are no feedback documents with any error information for this instance. But I know other users are experiencing the same problem due to manual feedback documents (eg. House registration form can't be loaded it just say error loading form)

I had a laptop but no micro-USB cable. Eventually, I synced this user’s data, reset all data for the app via Android, and logged in as the user fresh. This resolved the issue and the user was very pleased.

I know other users are suffering from this problem. How can I understand this issue and fix it for them also?

Should these details be captured in feedback documents? I don’t see any details there.

This was reported again here:

There is a VHT … that is having challenges registering. They are getting an Error Loading page when they try to register a HH and it is one month now - They need urgent help.

This is maybe the fifth or sixth user reporting the same challenge. What might be causing this?

Thanks for posting this @kenn. Can you add some details for the users that are having the issue?


  1. CHT version (I think I gather it’s 3.11)
  2. Device model
  3. Android operating system version
  4. CHT Android app version
  5. Chrome version (if Android version is 10+)

update: edited question list above to clarify the Android details we’re seeking

@jonathan Do you have these details for the user you worked with via phone?

If it’s helpful, in the app you can go to the hamburger menu → about has good info!

1 Like

Thanks @mrjones and I also forgot about the version of the Android app. I’ll edit my post above to make sure it’s clear.

@kenn Can you please provide a link to the feedback doc or an excerpt of the log array or share the feedback doc ID?

@diana The only report in feedback docs came as a “manual feedback doc” - so the users went to Hamburger > Report a Bug and typed out a description of the problem that was blocking them. I can still fetch you an ID if you like - but I’m guessing you want to look at an automated feedback doc (?)

AFAIK, there isn’t an automated feedback doc created when a user fails to load a form - or I can’t see any matching the pattern in this 3.11 project.

@kenn even if manual, it lists the errors that were logged in the console. Could you please share?
I’m betting on the feedback doc being submitted soon after the form failed to load, and we get some clues.

Ideally we would look at an assortment of them, in case just one does not have any interesting data.

Cool. Didn’t know that.


Thanks @kenn

Both feedback docs include the entry for the broken form:

   "level": "error",
   "arguments": "[\"Error loading contact form.\",{}]"

However the “registered” error is, obviously not helpful. It does help us eliminate at least two sources which would have some information logged besides the “Error loading contact form”.
The reason for the “{}” is caused by an implementation detail, because we use JSON.stringify to store and attach these logs. An Error object, serialized like this, yields "{}".
PouchDb errors are regular Objects, so this eliminates the case of a missing form or a missing attachment, or failing to read it from the database.

For the improvement of how we handle thrown errors in feedback docs, I added this issue:

For registering feedback docs when forms fail to load, I added this issue:

I’ll keep looking into this.