SOLFIND
Web Lens
Portal home

Application Errors | Appsmith

https://docs.appsmith.com/help-and-support/troubleshooting-guide/application-errors • 54 KB fetched
Open original page


Application Errors | Appsmith

Skip to main content

Ask AI
Search

Ask Appsmith AI Submit message

Examples How do I install Appsmith using Docker? How do I connect to my local PostgreSQL database? How do I pass inputs from a widget to a query? How do I trigger multiple queries conditionally? How do I fix the error: This value does not evaluate to type Array<Object>?

Search

Try Appsmith

* Get Started

* Introduction

* Build Your First App

* Self Hosting

* New Installation Guides

* Manage Installation

* Upgrade Installation Guides

* Concepts

* Connect Data

* Overview

* How-to Guides

* Reference

* Datasources

* Query Settings

* Concepts

* Build Apps

* Overview

* Quickstart

* How-to Guides

* Reference

* Widgets

* Accessibility

* Theme

* Sample Apps

* Write Code

* Overview

* How-to Guides

* Reference

* Global Objects

* Global Functions

* JS Libraries

* Fetch API

* Data Transformation

* JavaScript Settings

* Concepts

* Best Practices

* Manage Apps and Users

* Authentication

* Granular Access Control

* Versioning with Git

* Setup SCIM Provisioning

* Embed Appsmith

* Migrate Applications

* Audit Logs

* Branding

* External Client Portal

* Packages

* Overview

* Tutorial

* How-to Guides

* Reference

* Package Version Control

* GIT Apps with Packages Best Practices

* Code Packages

* UI Packages

* Workflows

* Overview

* Tutorial

* How-to Guides

* Reference

* Workflow Triggers

* Workflow Queries

* Workflow Functions

* Pass Parameters to Workflows

* Run History

* Troubleshooting

* Overview

* Self-hosting Errors

* Application Errors

* Datasource Errors

* Query Errors

* Git Errors

* Granular Access Control Errors

* Cyclic Dependency Errors

* Embedding and Content Security Errors

* JS Errors

* Query Errors

* Widget Errors

* Product

* FAQ

* Security

* Telemetry

* Support at Appsmith

* Privacy Policy

* Release Notes

* Contribute

© 2026 Appsmith, Inc.

*

* Troubleshooting

* Application Errors
On this page
Application Errors

Understanding how to effectively troubleshoot errors in your Appsmith applications can save you time and help maintain a smooth development process. This guide will walk you through common issues you may encounter and how to resolve them efficiently.

Testing datasource connection ​

If you suspect an error related to your datasource, the first step is to test the datasource connection. This will quickly tell you whether the issue is with the connectivity to your data source or something else.

* Navigate to your Appsmith application's datasource page.

* Find the datasource in question and click on the "Test" button.

* If the "Test Configuration" option indicates failure, proceed to troubleshoot the datasource connectivity.

Troubleshooting datasource connectivity ​

* Ensure that your datasource URL, authentication credentials, and other settings are correctly configured.

* Verify that any IP whitelisting or firewall rules allow traffic from Appsmith's servers.

* Review any error messages returned by the Test Configuration for clues to the problem.

See guides on common datasource errors .

Debugging query errors ​

Once you have confirmed that your datasource is connected, the next step is to ensure your queries are running as expected.

* Remove any mustache bindings temporarily and use hard-coded parameters to test the basic query.

* If the query fails to run, analyze the SQL or command errors, and adjust your query accordingly.

See guides on common query errors .

Inspecting evaluated values ​

* In the Appsmith editor, inspect the evaluated value of the query to ensure that mustache parameters are being interpreted correctly.

* Hover over parameters within your query to confirm they are present and formatted as expected.

Troubleshoot mustache bindings ​

* Verify the syntax of your mustache bindings. Incorrect bindings can lead to errors when the query attempts to execute.

* If the binding syntax is correct, check whether the widgets referenced in the bindings are configured correctly on the page.

Debugging widget errors ​

Errors in widget properties are often related to the validation rules of those properties.

Validation errors ​

* Ensure that any data bound to widgets is in the format expected by the property. For example, a Table widget expects an array of objects.

* You may need to transform or access nested arrays differently if they do not match the expected input.

Example: a Table widget is bound to the result of an API that returns a JSON object instead of an array of objects, which the Table widget expects for its data source.

Solution: Transform the JSON object into an array of objects using JavaScript within the query or within a JS Object. You can use the .map() function to achieve the desired transformation if the data contains an array nested within the object.

Debug JS Errors ​

You can use the debugger statement or console.log() to debug and inspect your code in the browser console or the Console tab. This allows you to check the state of your code and step through it line by line to help identify and fix any errors.

While writing javascript in Appsmith, you may encounter the following errors in your code.

Reference errors ​

These occur when the code references an entity or variable that is not defined on the page. Review your bindings and the names of the entities to correct these errors.

Lint errors ​

Review the syntax of the mustache bindings for any syntax errors that could be causing issues. Javascript written inside mustache bindings can only be single line code. Use JSObjects for multi-line functions.

Type errors ​

Check your JavaScript operations to ensure you are not performing unsupported operations on certain data types.

With debugger statement ​

To invoke the debugger, insert a debugger keyword in your code where you want it to pause, and then run your app. The code execution pauses on the debugger statement. It works like a breakpoint . You can then use the debugger tools to step through your code, inspect variables, and see how your code is executing.

Syntax

debugger;

Example :

export default {
getUserDetails: async () => {
const userInfo = await userDetailsAPI.run();
debugger; // the execution is paused at this point
console.log(“user information: “+userInfo); // The value of the userInfo
variable is printed in the Logs tab.
return userInfo;
}
}

With console.log() ​

In addition to using the debugger statement, you can use console.log() to print information about your code to the browser's console. This can help inspect the values of variables or the state of your app at different points during the execution of your code.

Syntax

console.log(<VARIABLE_NAME>);

How To Debug JavaScript With Console.log
Getting help ​

If after following these steps you're still encountering errors, the support team is here to help you. So don't hesitate to reach out for assistance via the chat widget on this page.

Was this page helpful?

Edit this page

Previous
Upgrade and Migration Errors
Next
Datasource Errors

* Testing datasource connection
* Troubleshooting datasource connectivity

* Debugging query errors
* Inspecting evaluated values

* Troubleshoot mustache bindings

* Debugging widget errors
* Validation errors

* Debug JS Errors
* With debugger statement

* With console.log()

* Getting help

Links found on this page

  1. Skip to main content [direct]
  2. Try Appsmith [direct]
  3. Get Started [direct]
  4. Build Your First App [direct]
  5. Self Hosting [direct]
  6. New Installation Guides [direct]
  7. Manage Installation [direct]
  8. Upgrade Installation Guides [direct]
  9. Concepts [direct]
  10. Connect Data [direct]
  11. How-to Guides [direct]
  12. Reference [direct]
  13. Query Settings [direct]
  14. Concepts [direct]
  15. Build Apps [direct]
  16. Quickstart [direct]
  17. How-to Guides [direct]
  18. Reference [direct]
  19. Widgets [direct]
  20. Accessibility [direct]
  21. Theme [direct]
  22. Sample Apps [direct]
  23. Write Code [direct]
  24. How-to Guides [direct]
  25. Reference [direct]
  26. Global Objects [direct]
  27. Global Functions [direct]
  28. JS Libraries [direct]
  29. Fetch API [direct]
  30. Data Transformation [direct]
  31. JavaScript Settings [direct]
  32. Concepts [direct]
  33. Best Practices [direct]
  34. Manage Apps and Users [direct]
  35. Granular Access Control [direct]
  36. Versioning with Git [direct]
  37. Setup SCIM Provisioning [direct]
  38. Embed Appsmith [direct]
  39. Migrate Applications [direct]
  40. Audit Logs [direct]
  41. Branding [direct]
  42. External Client Portal [direct]
  43. Packages [direct]
  44. Tutorial [direct]
  45. How-to Guides [direct]
  46. Reference [direct]
  47. GIT Apps with Packages Best Practices [direct]
  48. Code Packages [direct]
  49. UI Packages [direct]
  50. Workflows [direct]
  51. Tutorial [direct]
  52. How-to Guides [direct]
  53. Reference [direct]
  54. Workflow Queries [direct]
  55. Workflow Functions [direct]
  56. Pass Parameters to Workflows [direct]
  57. Run History [direct]
  58. Troubleshooting [direct]
  59. Self-hosting Errors [direct]
  60. Datasource Errors [direct]
  61. Query Errors [direct]
  62. Git Errors [direct]
  63. Granular Access Control Errors [direct]
  64. Cyclic Dependency Errors [direct]
  65. Embedding and Content Security Errors [direct]
  66. JS Errors [direct]
  67. Query Errors [direct]
  68. Widget Errors [direct]
  69. Product [direct]
  70. Security [direct]
  71. Telemetry [direct]
  72. Support at Appsmith [direct]
  73. Privacy Policy [direct]
  74. Release Notes [direct]
  75. Contribute [direct]
  76. Edit this page [direct]
  77. Previous Upgrade and Migration Errors [direct]