Troubleshooting

Last updated:

This article provides typical error patterns as well as guidance on how to analyze and resolve common issues.

The form is not displayed

Check the following:

  1. Is embedId correct?
  2. Is the form published?
  3. Is srcUrl set correctly?
  4. Is your domain stored in Formcentric?
  5. If you are using local themes, have theme and template resources been included correctly?
  6. Is remountKey being correctly incremented for configuration changes?

The form is not styled

Check the following:

  1. Have theme styles been imported into your application?
  2. Has the theme script been imported?
  3. Are skipThemeLoad and skipTemplatesLoad only set if you are actually bundling the resources yourself?
  4. Are theme files being loaded in the correct order?

Props are changing but the form does not respond

The React component is restart-based. Many props only take effect on initialisation.

Check the following:

  1. Is remountKey being changed for relevant configuration changes?
  2. Are you expecting init-time props to be carried across live to a running instance?
  3. Is embedId staying stable if an instance is intentionally being reused?

Error handling during development

Use onError and optionally debug to make errors visible earlier:


Conflicts due to multiple embedding of the same embedId

If the same embedId is used multiple times, this can lead to conflicts between existing instances and new instances.

Check the following:

  1. Is the same embedId being mounted simultaneously in several places?
  1. Does conflictBehavior match your use case?
  2. In the case of intentional re-initialisation, is the same embedId staying stable and is remountKey being changed instead?

Feedback