Skip to content
Floorp Docs

When You Submit an Issue to Floorp

Please take a look at these guidelines to quickly resolve your issue.

Where to Submit an Issue

You can submit issues to GitHub Issues.

If you are unsure if your problem is an issue, you can post it on Reddit r/Floorp or Discord Ablaze.
When posting on Reddit, please check the post Do not post Issues or Feature Requests in Reddit.

The community is only to check if your problem is valid, not for submitting issues officially.

What You Should Check to Resolve Your Issue

1. Check Existing Issues

You should check existing issues as there may be solutions that resolve your problem.
Submitting a duplicate issue can slow down the resolution process.

You can check the Issue Tracker in this documentation too!

2. Check if the Problem Occurs in Vanilla

The problem could be caused by your browser environment.

Please try these instructions:

  • Update to the Latest Floorp

    The problem may be resolved in the latest version.
    Please check if you are using the latest Floorp.

  • Disable All Browser Extensions/Add-ons

    The problem could be caused by a conflict between Floorp and some add-ons.
    If the issue is resolved after disabling add-ons, please contact the add-on developer or find an alternative add-on.

  • Clear the Browser Cache and Cookies

    The problem could be caused by the browser cache.

  • Create a New Profile

    A “profile” is a browser’s management mechanism to separate your settings, logs, etc.
    The problem could be caused by changes in data handling in the program, especially after updating Floorp.

    Docs of Firefox’s profile manager are here!

3. Check if the Problem is Specific to Floorp

  • Check if the Problem Occurs in the Latest Firefox ESR

    Floorp is based on the Firefox ESR version (Extended Support Release).
    Please check if the problem occurs in Firefox ESR.
    If the problem occurs in Firefox ESR too, please submit the issue to Mozilla, the organization behind Firefox.

You don’t need to check if the problem is related to a Floorp-specific feature.

4. When You Have Done All the Checks

Thank you for checking the issue according to these guidelines.

Please submit the issue to GitHub Issues.

The following information is helpful to resolve your problem:

  • Detailed Step-by-Step Instructions

    Please describe what you did to reproduce the issue.

    e.g.

    Steps:
    

    1. Press the Settings button
    2. Go to Design
    3. Select Floorp Daylight Fluerial Design
    

    Result:
    

    The layout breaks in the tab bar

  • Screenshots

    Please submit screenshots of the issue.

  • Browser Devtools Console Outputs

    You can open the Browser Toolbox panel with Ctrl + Shift + I (Cmd + Option + I on Mac), you can open the Browser Toolbox with Ctrl + Alt + Shift + I (Cmd + Option + Shift + I on Mac).
    The logs in the Browser Devtools can be helpful.

    Docs of Firefox’s Browser Toolbox are here!

End

Thank you for reading the guideline!