The LaTeX Project logoThe LaTeX Project

Procedure to submit a LaTeX bug report

Hey, you think you found a bug in LaTeX? Pity! But this page allows you to upload a report to our bugs database.

Before submitting a LaTeX bug

A few important preparation steps to go through:

  1. Check to see if the bug has already been reported. You can do this by searching the LaTeX bugs database. If the bug has already been reported then there may be a documented workaround for your problem.
  2. Check that there really is a bug, by writing a short, self-contained document that shows the problem. This file should start with the line \RequirePackage{latexbug}. Starting with this package will help you to make sure that the document doesn’t use any third-party packages or document classes. If the bug turns out to be with third-party software then please contact the developer, and not us!
  3. For bugs related to LaTeX3 code (expl3, xparse and so on): Do not report the bug here but instead use the GitHub issue tracker.
  4. Run LaTeX on the test file. Send the test file and the resulting transcript file using the form below.

Now you are ready to submit a LaTeX bug report.

But please remember: Bug reports sent to us without a \RequirePackage{latexbug} line and/or containing third-party code flagged by the latexbug package are likely to be closed without any comment in our bug tracking system!

Submit a LaTeX bug

  1. Please add a few bits of information that will help us to categorize it. We need at least the bug category, your name, your email, and a summary (typically one sentence).

    LaTeX Bug category:

    Class of bug:

    Your name:

    Your email:

    One-line summary description:

    Short problem description:

  2. Add the name of your input file on your computer (the button pops up a file selection box, or just type it in). It will be uploaded when you submit this form in step (4).

  3. Add the name of your transcript (log) file on your computer (the button pops up a file selection box, or just type it in). Do not submit your output (e.g., dvi or pdf) file here! It will be uploaded when you submit this form in step (4).

  4. A simple answer to prove that you are a human and not a SPAMBot. We had a lot of SPAM coming through this web form, so we ask you to in type in a number in answer to a simple question.
    What is the sum of five hundred seventeen and four?

  5. Thanks for providing the information – and thanks for your contribution. You keep LaTeX going!