How to Temporarily Increase the Number of Items Per Page in FreeScout

2 min read

FreeScout, by default, displays 50 items per page in the conversations table. While this setting works for most users, some may require a higher number of items - such as 500 - to streamline their workflow.

Below is a guide on how to modify the default list size. However, it is crucial to note that this is a temporary solution, as updates to the software will override your changes. Additionally, altering core code can introduce risks, which are outlined below.

Step-by-Step Guide

Locate the File to Edit

Navigate to the Conversation.php file in your FreeScout installation directory. The specific file path is: app/Conversation.php (Github)

Modify the Default List Size

Open the file and locate the following line:

const DEFAULT_LIST_SIZE = 50;

Change the value from 50 to 500:

const DEFAULT_LIST_SIZE = 500;

Save the Changes

After making the modification, save the file and restart your FreeScout application to apply the changes.

Verify the Update

Log in to your FreeScout dashboard and navigate to the conversations table. You should now see 500 items displayed per page instead of the default 50.

Important Considerations

  • Temporary Fix: This change will be overwritten when you update FreeScout to a newer version. To avoid losing your customisation, you must reapply the modification after each update.
  • Risks of Changing Core Code: Altering core files can lead to unexpected behaviour, such as bugs or compatibility issues with future updates. It is strongly recommended to back up your installation before proceeding.
  • Performance Impact: Increasing the number of items per page to 500 may affect the performance of your application, especially if you have a large dataset. Ensure your server has sufficient resources to handle the increased load.

Related post