Skip to main content

Lesson 1 - Bring in Data

This tutorial takes you through the process of connecting a datasource and querying data on Appsmith.

Connect datasource

  1. In your application, go to the sidebar and click the Data button.

  2. Click the + icon next to Datasources in your workspace to add a new datasource.

  3. Select PostgreSQL under the Databases section. This opens the page where you can configure the fields to connect to your PostgreSQL database.

  1. Rename the default database name from Untitled datasource 1 to usersTutorialDB. You may have to click the pencil icon next to the database name if it is not already selected.

  2. Enter the following details in the connection parameter fields:
    Host Address:
    Port: 5432
    Database Name: users
    Username: users
    Password: new-users-db-pass

  3. Click the Test Configuration button to test the connection and ensure the database is valid.

  4. Click Save to create and save the database connection. You'll see the usersTutorialDB database page.

Query Data

  1. In the Editor pane click the New Query/API button and select the connected datasource. You will see the query editor with a default fetch query to pull ten records from the usersTutorialDB database table.

  2. Rename the query from Query1 to getUsers. You may have to click the pencil icon if it is not already selected.

  3. For this tutorial, modify the query as shown below to fetch the records in the ascending order of the id field.

SELECT * FROM public."users" ORDER BY id LIMIT 10;
  1. Click the Run button on the top right of the screen to execute the query and confirm that it returns data.

  2. Click the Settings tab. Switch on the Run query on page load option.

You've created your first query to fetch the list of records in the database.

Display data in Table

  1. Click the UI tab on the Entity Explorer to the left of the screen.

  2. Click + New UI element and drag a Table widget and drop it to the left of the canvas.

  3. A Property Pane appears to the right of the screen, which contains all the properties of the widget. On the top of the property pane, click on the default name Table1 and rename it to usersTable.

  4. Connect the Table to the query getUsers to display the data. Additionally, you can use JavaScript by clicking on JS to write bindings for the table data.


The mustache template {{}} is used to write JS code inside widgets and queries on Appsmith.

You've displayed the results from the getUsers query on the Table widget.

Next steps