Follow the procedure outlined here when reporting issues with the LoopBack project.
Page Contents

Before asking a question on GitHub

If you have a question about how to do something in LoopBack, follow these steps:

  1. Consult the documentation and the API documentation. NOTE: The search box above searches both of these sites.
  2. If you don’t find an answer to your question, then do one of the following:

    Posting to Google Group or StackOverflow is preferred so others may benefit from the answer.

  3. If the above two ways do not work, open a GitHub issue on the corresponding LoopBack repo, providing as much information as possible, for example, versions and use case scenarios for features.

How to report an issue

To report an issue:

  1. Search existing issues. It’s possible someone has already reported the same problem.
  2. Make sure you have a GitHub account.
  3. Create a new issue for the bug, following the steps outlined below

Determine the issue type

There are three types of issues:

Security issues

We take security vulnerabilities in LoopBack very seriously for our users.

In production, do not enable debug logs that may contain sensitive data; for example, the payload of PersistedModel.create should not be exposed in production. Logging this type of information is acceptable in development, but not in production.

Do not report security vulnerabilities using GitHub issues. Please send an email to with:

  • Description of the vulnerability.
  • Steps to reproduce the issue.
  • Possible solutions.

Feature requests

Open a new GitHub issue at

For feature/enhancement requests related to specific LoopBack dependencies (for example, loopback-connector-mysql), please create an issue in the repository itself (for example,

Bug report

To report a bug:

  1. Fork loopback-sandbox.
  2. Add the code required to reproduce your issue in the forked repository.
  3. Create an issue in the appropriate repository with steps to reproduce (STR) in the issue description AND a link to the forked repository.

From this point, we will clone the the forked repository and try to reproduce the issue. Once verified, we will respond to you and prioritize the fix accordingly.

We recommend forking with STR to leverage community support in reproducing issues. By doing this, we can focus on fixing and responding to the actual issues.

For bug reports related to specific LoopBack dependencies (for example, loopback-connector-mysql), please create an issue in the repository itself; for example, loopback-connector-mysql.

Key information to include

When reporting bugs, please include at least all the following:

  • Operating system version.
  • Node.js version.
  • Pertinent version of Node modules, for example LoopBack.
  • Any stack trace, error message text, or other relevant information.

Consider using NodeReport to gather and report the relevant information.

2. Report in appropriate channel

We support multiple channels for specific purposes. Please choose the SINGLE most appropriate channel to report your issue to.

3. Wait for response

We actively monitor the officially supported channels and generally respond as soon as possible. If you haven’t received a response from us within two days, please remind us on Google Groups or ping us on Gitter.

We also encourage community participation with regards to resolving issues. If you know the answer to any issues you encounter, please chime in and help each other out. We will also try our best to help users who are actively helping other users.