1.Graph/Chart not displaying
Graph/Chart doesn’t work as expected when you don’t follow the installation guide properly. To make sure it works you should install it using the installation guide.
NOTE: not following the installation process will have many other additional other problem, so we always recommend to follow it.
If you have followed the installation guide and then also it is giving this problem then follow the below-given solution.
Alternate Solution:
Open the .env file which is present inside the pos codebase. In the .env file, you will find “APP_URL“, set the correct value of the url in here.
2.Increasing/Decreasing upload documents & images size limit
- To change the document size limit open config/constants.php
- You will find to variables
- ‘image_size_limit’ => ‘500000’, //in Bytes
- ‘document_size_limit’ => ‘1000000’, //in Bytes,
- Change the value of the above to change the size limit.
- Size must be provided in Bytes.
- Bytes to MB converter (https://convertlive.com/u/convert/bytes/to/megabytes)
3.Logo or Image not Getting displayed
If you’re using OnePOS version 2.11.4 do this: internal link add pos/#NOTE_If_you8217re_updating_from_V2113_to_V2114_or_higher_then_do_these_additional_steps
In OnePOS version 2.11.2 we implemented an easy way to fix images issue.
- Login in OnePOS with Administrator account (or superadmin account)
- Go to <pos_directory>/public directory via FTP or cPanel and delete “storage” directory if present. This may or may not be present.
PS: don’t delete <pos_directory>/storage. - Run www.yourwebsite.com/install/fix-image and it will fix the image issue. If it displays some error the check the error information as given below.
If you’re using a lower version then 2.11.2 then follow the below steps or update your version.
- This can happen if the “symbolic link” is not created successfully during installation steps.
- Go to <pos_directory>/public and delete “storage” directory if present. This may or may not be present.
PS: don’t delete <pos_directory>/storage. - If you’re using in localhost then open your command prompt (cmd) or if in hosting server then use shell access to login via terminals. Contact your hosting provider if you need details on accessing via terminal.
- Go to pos directory:
cd <pos_directory> - in the pos directory run the below command:
php artisan storage:link - If it shows success then check your application, it should show the images now.
If it shows some error like:
- Undefined command “php” then add php to your environment variable or check your server documentation on running php via command line.
- symblink() Permission denied: Change permission of public directory as mentioned in the installation doc.
- symlink() has been disabled: Contact your hosting provider to enable it.
4.Tips & Tricks for using OnePOS effectively.
Improving Browser based Print (Receipts or other)
- In chrome/firefox before printing, it shows a preview dialogue. The preview dialogue left side has some setting.
- Enable Background style
- Try setting the margin as default.
- Set correct page size (mostly A4)
- Enable/Disable header & footer to show/hide the page URL.
Create Shortcuts for web application
-
- Are you tired of opening browser and the opening your website? If yes we have a solution.
- Open OnePOS in chrome.
- Click the wrench icon (3 dots) in the right corner of the screen.
- Scroll down to Tools and select “Create Application Shortcuts” or “Add To Desktop”
- From the dialogue box, choose whether you want the shortcut to appear on your Desktop, in your Start menu or pinned to your Taskbar.
- Click create and your shortcut will appear in the desktop.
Website to Desktop apps in One-Click
- You can use this online tool to convert website to Desktop App – Website-to-Desktop
- This tool is just a wrapper for browser
- We haven’t tested OnePOS 100% with this tool, but you can give it a try.
Browser Full-Screen mode or distraction-free mode
-
- Whenever you’re in “Full Screen” mode and use a browser-based printing option it gets exit from Full Screen. This also happens if you navigate to another page in full screen.
- But if you have enabled “Full Screen” by pressing “F11” it will not get exit during navigation and also during browser-based printing.
- Using OnePOS POS sales screen in “Full screen” by pressing “F11” gives an ultimate experience.
Barcode Scanner Trick
- Many barcode scanners send an “End of Line” or “CR/LF” ( the ‘Carriage Return’ and the ‘Line Feed’) characters after each scan. This will result in some issue with OnePOS. Well, it’s not an issue with OnePOS or the scanner. This feature is useful in some cases. But you should disable it while using OnePOS.
- Some noted behaviors are, in POS screen invoice gets automatically submitted after scanning, automatically page gets redirected after scanning.
- To disable it simply follow the instruction provided by your manufacturer. ALL branded manufacturer have instruction available to “Disable Carriage return & Line Feed”. Google it.
- For example: In this link, you will find simple instructions for Honeywell scanners (“RESOLUTION” present at bottom of page) (https://honeywellaidc.force.com/supportppr/s/article/How-to-remove-the-Enter-after-each-scan)
Do you have a particular Trick to improve user experience? Share with us here
Bookmark this link, as we will keep updating it.
5.White Labeling & Rebranding OnePOS
A white label product is a product or service produced by one company (the producer) that other companies (the marketers) rebrand to make it appear as if they had made it.
ONE POS allows you to white label the product with your company name and resell it as per purchase license rules.
To white label the application:
During installation, it asks for Application name & Application title. Simply use your company name or your branded product name as the name of the application. Also, give a meaning title to it.
– Now the name you entered will be displayed in Landing Page & also in the footer of the application.
– You can also change the application name after installation. Simply open .env file present in the root folder of the application and change the APP_NAME & APP_TITLE value.
6.Decimal Precision for Currency & Quantity
Some countries like Bahrain, Kuwait, Tunisia, Oman, etc has 3 decimal currencies. So with this feature, you can adjust the decimal significant figures for currency & quantity.
The default precision is 2 for currency & quantity if you want to change it follow the below steps:
Go to Settings -> Business Settings. Here you can enter the required decimal precision for quantity and currency.

If you are using version 4.7.7 or below, follow the below steps to change the decimal precision.
- Go to config/constants.php
- Change currency_precision value to change the precision for currency. The maximum is 4.
- Change quantity_precision value to change the precision for quantity. The maximum is 4.
7.Adding Favicon, Login & Registration page background image
Adding Favicon
To change the Favicon.ico image go to /public folder and replace the favicon.ico file present there.
Clear cache of your browser and it will start to show the new image you added.
Changing Logo in Login & Registration page
Replace the image pos\public\img\logo-small.png
Keep the new image name as “logo-small.png”
Changing Background Colour in Login Page
How to change the blue background in the login page?
To change the blue background in the login page, check the css file and change the line as mentioned below.
Step 1: Login to your server and open the codebase files for OnePOS.
Step 2: Go to pos/public/css/app.css and edit line no 286.
Step 3: Go to pos\resources\views\layouts\partials\extracss_auth.blade.php and edit line no 7.
Changing Application Name in Landing page
To change the application name in the landing page, follow the steps given below
Step 1: Open .env file present in your codebase.
Step 2: Search for APP_NAME.
Step 3: Change the value for the APP_NAME =”examplePOS” as required.
How can I display the login page instead of the landing page? (Making login page as the landing page)
If you want to redirect the landing page of your POS system to login page page, you can modify the route in the pos/routes/web.php file to call the login blade instead of the welcome blade.
This will display the login page instead of the default welcome page when the POS system is accessed.
To change the route and call the login blade, follow these steps:
- Open the routes/web.php file in your code editor.
- Search for the route that specifies the view for the welcome blade file.
- Replace the view name with the name of the login blade file.
- Save the changes to the routes/web.php file.
For more information on using blade templates in Laravel, refer to the Laravel documentation at https://laravel.com/docs/10.x/blade.
If you need to pass data to the view, you can refer to this guide at https://www.geeksforgeeks.org/different-ways-for-passing-data-to-view-in-laravel/.
8.Export Feature
Export Feature in OnePOS
one POS allows you to export your data into either Excel, CSV, or pdf files. You can export your sale, purchase, products, categories, all your reports, etc.
On the top of every data table, you can find export buttons as shown in the image below.

Removing columns from the data table
If you want to remove the action column or any other column while exporting the data, use the column visibility feature. Select the columns that are to be removed and then click export.

9.Login Session Time
Increasing the login session time:
Follow the file path below to increase the login session time of your OnePOS.
config/session.php
10.Issue: Product not shown on view
Issue: Product not shown on view:
Sometimes, you may encounter an issue where the “List Products > View” function does not work.
This problem may arise from the permission restrictions for the uploads folder in the code base.
- Log in to your server and find the pos/public/uploads folder. Then, change the permission to ‘777’.
- Save the file and try to view the product again.
If you still have the issue, open a ticket in support and post the issue.
11.Adding/Modifying Currency in Onepos
Adding/Modifying Currency:
With OnePOS we have tried to include many currencies inbuilt in the system. But we have missed some of them, sorry for that!!
No worries, still you can add any new currency into the system.
- To add new currency open the database table which is used for OnePOS. Go to table currency
- Click on “Insert” new row option.
- Fill your currency details as below and save it.
- country
- currency
- code
- symbol
- thousand_seperator
- decimal_seperator
Great, Your currency is added now.
In case of any problem with adding currency or if you want us to include your country with then open a ticket at our support link. internal link