Liferay Community APAC
Liferay Forums docs

Home/Marketplace Apps/Liferay Forums/Reference

Reporting a Bug

Report problems with Liferay Forums, and suggest improvements, as issues in the liferay-forums repository on GitHub. You need a GitHub account.

  1. If You Have a TAM Package
  2. Before You Report
  3. Report a Bug
  4. Security Problems
  5. Questions
  6. What Happens Next
  7. Related Information

If You Have a TAM Package

If your Liferay subscription includes a Technical Account Manager (TAM) package, log the problem directly with Liferay Support instead of opening a GitHub issue. A ticket keeps your logs and environment details private, and your TAM can follow it up.

  1. Sign in to the Liferay Help Center with your liferay.com account.
  2. Create a ticket, as described in Help Center Ticket Creation Process.
  3. In the ticket, say that the problem is in Liferay Forums, with its version, and include the same details as a bug report: the Liferay DXP version, the install type, the steps to reproduce, and the log lines.
  4. Let your TAM know about the ticket.

Before You Report

  • Check Known Issues for your release.
  • If posts are rejected, topic links show a not found page, or no email arrives, follow If Something’s Wrong.
  • Search the open issues for the same problem. If you find it, add what you know to it, or give it a 👍, instead of opening another.

Report a Bug

  1. Open New issue, and choose Bug report.
  2. Fill in the form:
    • the Liferay Forums version and the Liferay DXP version;
    • how you installed it: Liferay Self-Hosted (Tomcat or Docker), Liferay PaaS, Liferay SaaS, or a Liferay Workspace;
    • whether the required Liferay fixes are installed;
    • what happened, what you expected, and the steps to reproduce it, with the role of the member who does each step;
    • errors from the Liferay log and the microservice’s log.
  3. Click Create.

Issues are public. Before you paste logs or screenshots, remove email addresses, user names, hostnames, internal addresses, tokens, and any customer data.

To suggest an improvement, choose Feature request instead, and describe what you’re trying to do.

Security Problems

Don’t report a security problem in a public issue. Report it privately, in the repository’s Security tab → Report a vulnerability. Only the maintainers see it. See the repository’s security policy.

Questions

For questions about installing, setting up, or using the forum, start a discussion instead of an issue.

What Happens Next

The maintainers review new issues, and ask for more details if they need them. A confirmed bug is planned for a release, usually the next patch of the latest release line, and the issue says which. When that release is published, the issue is closed with a link to it. Its release notes say how to install it.

Liferay Forums is a community project, so issues are handled on a best-effort basis.