# Top realtor
Top Realtor is a template designed to assist real estate agents in selling and renting properties. Clients can search for properties, view listings, and contact agents for more information. Agents can create profiles, list properties, and connect with clients. Admins have full control over the website, managing user accounts, listings, ensuring smooth operation. Try our website today and start building your real estate empire!
{% tabs %}
{% tab title="1" %}
{% endtab %}
{% tab title="2" %}
{% endtab %}
{% tab title="3" %}
{% endtab %}
{% tab title="4" %}
{% endtab %}
{% endtabs %}
> ### 🔗 **Public page**
>
> ### 🔗 **Preview**
### Introduction
Top Realtor is a convenient and intuitive online platform for real estate agents and agencies. It facilitates the work of realtors, making it possible to add properties with the most accurate description and create deals in a couple of clicks. A detailed dashboard displays complete sales and rental statistics of properties, provides quick access to the data of any buyer/tenant, and contains a convenient calendar of online meetings with potential clients. The notification system will not allow you to miss a request from a client, a new review or a notification from an admin. Each agent also has their own profile where they can share news and useful information, similar to social networks.
It is easy for an ordinary user to find a suitable property option on Top Realtor thanks to a detailed and well-functioning filter system. Matching options can be saved and set up an online appointment with an agent. The user also has the opportunity to leave feedback about the agent after communicating with him, or about the property after renting it.
The admin panel allows you to track the actions of all agents and users, control all transactions and provides full control over them.
Template is fully responsive and works great on all devices or screens like laptop, desktop, tablet or mobile.
### Interactive Use Cases
In this section, you will find interactive demo scenarios designed to help you understand how to effectively use our service. Each scenario provides a step-by-step guide, allowing you to explore various features and functionalities in a practical context. By engaging with these demos, you'll gain hands-on experience that will enhance your understanding and confidence in using the platform. Let's get started!
{% @supademo/embed demoId="cm2mfzyew00l1k69d08bm1s68" url="" %}
{% @supademo/embed demoId="cm2mcnxx50hn5xxrvh9egi4a6" url="" %}
{% @supademo/embed demoId="cm2m9ei610gd5xxrvmlamsrs0" url="" %}
### Where to begin?
Start by reading the questions in the [FAQ](/templates-documentation/faq.md) section. There you will find a lot of useful things, including [how to assign the administrator role](/templates-documentation/faq.md#how-do-i-appoint-myself-as-a-project-administrator-and-add-users), to open all the features of the template, some subtleties of the payment system settings, etc.
### Features
* Sleek and visually appealing design
* Responsive design for mobile devices
* Property listings and search functionality
* Advanced search filters
* Integrated map for location accuracy
* Photo galleries to showcase properties
* Customizable property detail pages
* Bookings and availability
* On-platform communication
* Adding a new property
* Contact forms for scheduling a viewing
* Chat for easy communication
* Signup/Login
* Admin dashboard
* Agent dashboard
* Agents profiles + feed
* User dashboard
* Notifications
### Pages
{% hint style="info" %} This template is not the final product. Any part of the application can be modified for different needs.
{% endhint %}
**Index**\
This page displays general information, a quick search for real estate by type, location and cost. There is also a Map and blocks: Popular Residence, See how Real Estate can help, Newly listed homes etc
You can easily add your unique content to these customizable sections to elevate the overall look and feel of the landing page
**About\_us**\
Description of the company's mission. Blocks Description of the company's mission & Our agents at your service
**Agent\_profile**\
Our agents at your service. With the list agents you can show your agents in any page, alognside with their contact details and link to their agent profile.
**Careers**\
Blog, self-promotion, call-to-action button "Join our Team", as well as Recommended Listings (gridview)
**Contact\_us**\
Contact information, support center, message sending form
**Dashboars\_admin**
* Dashboard - general information on real estate, agents, revenue, customer reviews. Real estate search
* Analitycs - Sales Statistic, Rent Statistic, Total Revenue. Filters: This week , This Month, This Year
* Order List - list of orders, customer search, filters (Order ID, Date, Min. price, Max. price, Property Type). Add a new order. Statistic
* Agent List - Agent List, agent search, filters (All Agents, Top Agents), sorting, Add a new agent.
* Properties - List of properties, search, filters (For Sale, For Rent, Home Type, Published by, Status), sorting, Add new listing
* Customers - List of customers, search, filters (For Sale, For Rent, Home Type), sorting
* Reviews - List of reviews, search, filters
* Messages - chat
* Notifications
**Dashboard\_agent**
* Dashboard - General information on real estate, agents, revenue, customer reviews. Real estate search
* Analitycs - Sales Statistic, Rent Statistic, Total Revenue. Filters: This week , This Month, This Year
* Order List - List of orders, customer search, filters (Order ID, Date, Min. price, Max. price, Property Type). Add a new order. Statistic
* Properties - List of properties, search, filters (For Sale, For Rent, Home Type, Published by, Status), sorting, Add new listing
* Customers - List of customers, search, filters (For Sale, For Rent, Home Type), sorting
* Schedule - Drawing up a work schedule (Work days, Work period) calendar, scheduler, reminders
* Messages - chat with agents and admin
* Notifications
**Edit\_profile**\
Personal information, password change field
**Help**\
Page with additional information: FAQ, Privacy Policy, Terms Conditions, Cookies
**Home\_details**\
Description of the object, photo, map with location. The opportunity to make an appointment with an agent. Save to favorites. Share
**How\_it\_works**\
Step-by-step description of the principles of operation
**Messages** \
Chat with agents, users and admin
**Saved**\
A list of saved properties, the ability to create separate folders and filter
**Search** \
Real estate search block with various parameters, filters, sorting
**Services**\
Description of the services provided
**Signup\_agent**\
Personal information agent, password change field
**Reset\_pw** \
This page allows user to reset the password
**404** \
This page appears when something went wrong in the app's work
### Reusable Elements
* Card - the element used for displaying houses in various repeating groups within the project.
* Card small - the element used to display houses only on the Index page.
* Card search -the element used to display houses only on the search page.
* Filter - it's used for filtering houses on both the search and index pages.
* Footer - the footer reusable element is positioned at the bottom of a webpage, showcasing how it can incorporate external links, like the company's social media profiles, navigation links, and copyright information.
* Header index - this reusable element offers a space for the company's logo, navigation menu, and page title. Used only on the index page.
* Header search - this reusable element offers a space for the company's logo, navigation menu, and page title. Used on other pages.
* Listing - Utilized for creating and modifying houses on the Dashboard\_agent page and Dashboars\_admin page.
* Login-signup - this reusable element features sign-up/log-in forms, along with buttons for demo login.
* Save to folder - utilized across multiple pages for saving homes as favorites.
* Save property - used on the home details page to save the home as a favorite
* Schedule - used in the calendar on the dashboard\_agent page for scheduling and planning.
### Payment system
Please note that our payment system is exclusively tailored for rental properties. Purchasing real estate online is not available; only rent options are provided.
On the individual rental property page (home\_details), there's a 'Book Now' button that directs you to the booking creation page.
On the booking page (payments), you have two payment options: either pay for the entire rental period upfront or pay only for the first month plus a deposit (which equals one month's rent). Monthly payments are available for rental periods of 3 months or more.
Upon clicking "Pay now," the Stripe window opens. After entering the details, the user's funds are deducted, remaining within the platform. This template is primarily tailored for real estate agencies. It's envisaged that upon receiving the funds, they handle settlements with property owners, who may not be registered on the site.
The transaction includes an automatic 10% revenue allocation, later calculated as income in graphs.
An order, new customer, and transaction are generated.
A list of dates constituting this order is calculated and marked as unavailable for rent for this property.
Notifications are sent to both the admin and the agent about the new order.
A Schedule API workflow is set up to send the tenant a feedback request email on the lease end date.
Another Schedule API workflow cancels the order if it's not confirmed by the agent or admin within 72 hours.
If monthly payment is selected, a Schedule API workflow for the next payment is created - a month after the lease begins, prompting the tenant to pay for the following month.
The property's minimum available rental date is adjusted.
Then a popup window appears with the order details. Upon closing the popup, the user is redirected to the My Reservations page.
In the case of monthly rent, when it's time for the next payment, the tenant receives a notification containing a popup with the option to pay. Upon clicking the "Pay Now" button, the Stripe window opens, and after entering the details, funds are deducted, creating a new transaction. The next payment date and the paid month number are updated in the order. Another Schedule API Workflow for the next payment and a Schedule API Workflow for unpaid rent are created. The latter has a deadline of 3 days, and if payment is not made, a notification is sent to the agent informing them that the tenant has not paid.
In their dashboard, the agent can either confirm or reject the order. There's also an option to cancel an already confirmed order (in which case, the button in the popup become "Cancel Order" instead of "Decline").
If the agent cancels a pending order (one that hasn't been confirmed yet), a popup window opens to confirm the cancellation.
Upon clicking "Decline," the tenant receives a full refund of the amount paid. The order status changes to "Cancelled," and the transaction status for its payment changes to "Refunded." Dates associated with this order are removed from the property's unavailable dates. The agent's count of rented properties decreases by 1. Notifications are sent to the admin and the tenant about the agent's rejection of the request. Additionally, the tenant receives an email notification. All scheduled API workflows are canceled.
\
When a confirmed order is canceled (by clicking the "Cancel Order" button), the refund process depends on the payment method and the duration of the rental period that has elapsed.
If the rent was initially paid in full for the entire period:
* The payment for the months that have already passed and the current month is deducted from the total amount paid, and the remaining balance is refunded to the tenant.
If the payment method is monthly:
* Only the deposit, equal to the monthly payment amount, is refunded to the tenant.
The transaction amount is adjusted accordingly, and the order status changes to "Cancelled." All scheduled API workflows are canceled. Notifications are sent to both the admin and the tenant, and the tenant receives an email notification.
The same logic for confirming/rejecting and canceling orders is applied for the admin as well.
The tenant can cancel the order on the My Reservations page. Upon clicking "Cancel Booking" in the corresponding booking card, a popup appears indicating the refund amount that will be returned to the tenant upon cancellation of this booking. The refund amount depends on when the booking is canceled:
* If the booking is either not yet confirmed or there are more than 48 hours left before the start of the booking, the full amount is refunded.
* If the booking is canceled between 48 and 24 hours before the start, 75% of the paid amount is refunded.
* If the booking is canceled between 24 and 12 hours before the start, half of the paid amount is refunded.
* If the booking is canceled on the day of the start, no refund is provided.
* If the booking is canceled after the start date, and if the entire rental amount was paid upfront, the payment for the months already lived in and the current month is deducted from the total amount, and the remaining balance is refunded. If it's a monthly payment, only the deposit equivalent to one month's rent is refunded.
All scheduled API workflows are canceled. Dates associated with this order are removed from the property's unavailable dates. Notifications are sent to both the agent and the admin.
Additionally, orders can be manually created by agents or admins through this popup. In this case, the revenue amount is manually input by them. A transaction with the status "Paid" and the specified revenue is created. Otherwise, everything is similar to when a user makes a booking - an order is created, notifications are sent, and the agent's count of rented or sold properties is incremented by +1. Dates associated with this order are calculated and added to the property's unavailable dates.
### Data Types
{% hint style="info" %}
See Bubble manual information when working with data:
{% endhint %}
Admin\_Notifications
This data type is used to store admin notifications proprieties.
| Field name | Type | Notes |
| -------------- | ------ | ------------------------------------------- |
| Content | text | Stores the notification content |
| From | User | Stores the notification creator |
| House | House | Stores the House data type. |
| Name | text | |
| Order | Order | Stores the Order data type. |
| Read | yes/no | Specifies if the notification has been read |
| Review | Review | Stores the Review data type. |
| Support center | yes/no | |
| Support email | text | |
| Support name | text | |
| Support phone | text | |
Agents\_notifications
This data type is used to store agents notification proprieties.
| Field name | Type | Notes |
| ------------- | -------- | --------------------------------------------------------------- |
| Contact | yes/no | |
| Contact email | text | |
| Contact name | text | |
| Contact phone | text | |
| From Admin | yes/no | Specifies if the notification was created by an administrator. |
| House | House | Stores the House data type. |
| Listing | House | Stores the House data type. |
| Order | Order | Stores the Order data type. |
| Read | yes/no | Specifies if the notification has been read |
| Recipient | User | Stores the User data type. |
| Review | Review | Stores the Review data type. |
| Schedule | Schedule | Stores the Schedule data type. |
| Status | text | Holds a notification status |
Background
This data type is used to store background proprieties.
| Field name | Type | Notes |
| ---------- | ----- | -------------------------------------- |
| Image | image | Holds pictures related to a background |
| Name | text | Stores the picture name |
Customer
This data type is used to store customers proprieties.
| Field name | Type | Notes |
| ------------- | ------------- | ------------------------------------ |
| Content | yes/no | |
| Email | text | Stores Customer email |
| End date | date | |
| First name | text | Stores Customer first name |
| Full name | text | Stores Customer full name |
| House | House | Stores the House data type. |
| ID | number | |
| Last name | text | Stores Customer last name |
| Phone | text | Stores Customer phone number |
| Photo | image | Holds pictures related to a customer |
| Price | number | |
| Property Type | Property Type | Stores the Property type option set. |
| Review email | text | |
| Start date | date | |
| Status | Contract type | Stores the Contract type option set. |
Discussion
This data type is used to store discussions proprieties.
| Field name | Type | Notes |
| ----------- | ---------------- | ---------------------------------------------------------- |
| Archived by | List of Users | |
| Arrival | date | |
| Departure | date | |
| House | House | Stores the House data type. |
| Messages | List of Messages | Stores list of Messages |
| Users | List of Users | Stores list of participants |
| Viewed by | List of Users | Stores list of participants who have viewed the discussion |
Filter
This data type is used to store filters proprieties.
| Field name | Type | Notes |
| --------------- | ----------------------- | --------------------------------------- |
| Bathrooms | number | Store number of bathrooms |
| Bedrooms | number | Store number of bedrooms |
| Filter name | text | Store dilter name |
| Garage | Garage | Stores the Garage option set. |
| Lot size max | Lot | Stores the Lot option set. |
| Lot size min | Lot | Stores the Lot option set. |
| Other amenities | List of Other amenities | Stores list of amenities |
| Parking Spots | Parking Spots | Stores the Parking Spots option set. |
| Price max | number | Stores the maximum price value |
| Price min | number | Stores the minimum price value |
| Price range | numeric range | Stores price range |
| Property type | List of Property types | Stores list of property type |
| Search type | Contract type | Stores the Contract type option set. |
| Square feet max | number | Stores the maximum area in square feet |
| Square feet min | number | Stores the minimum area in square feet |
| View | List of Views | |
| Year built max | number | Stores the maximum year of construction |
| Year built min | number | Stores the minimum year of construction |
House
This data type is used to store houses proprieties.
| Field name | Type | Notes |
| -------------------------- | ----------------------- | ---------------------------------------- |
| About location | List of text | |
| Adress | geographic address | Stores the real estate address |
| Adress city | text | Stores the city |
| Agent | User | Stores the User data type. |
| Agent rating | number | Stores the agent rating |
| Appliances | List of text | Stores the list of apptiances |
| Bathrooms | number | Stores number of bathrooms |
| Bathrooms details | List of text | Stores bathrooms details |
| Bedrooms | number | Stores number of bedrooms |
| Bedrooms details | List of text | Stores bedrooms details |
| Community | List of text | |
| Condition | List of text | |
| Content | yes/no | |
| Contract type | Contract type | Stores the Contract type option set. |
| Cooling | List of text | |
| Date available | date | |
| Date rent | List of dates | |
| Description | text | Stores real estate description |
| Enable | yes/no | |
| Exterior features | List of text | |
| Flooring | List of text | |
| Garage | Garage | Stores the Garage option set. |
| Heating | List of text | |
| HOA | number | |
| Home status | Home status | Stores the Home status option set. |
| ID | number | |
| Lease duration | Lease duration | |
| LivingRoom | List of text | |
| Lot | Lot | |
| Material information | List of text | |
| Name | text | |
| Notable dates | List of text | |
| Nr views | number | |
| Ordered | yes/no | |
| Other amenities | List of Other amenities | |
| Other interior features | List of text | |
| Other property information | List of text | |
| Owner email | text | |
| Owner first name | text | |
| Owner phone | text | |
| Owner second name | text | |
| Parking Spots | Parking Spots | Stores the Parking spots option set. |
| Pet policy | List of Pet policys | |
| PHOTOS | List of images | |
| Price | number | |
| Property Type | Property Type | Stores the Property type option set. |
| Publishing status | Publishing status | Stores the Publishing status option set. |
| Rating | number | |
| Square feet | number | |
| Type and style | List of text | |
| View (House) | List of View (House)s | |
| View | List of Views | |
| Year built | number | |
Message
This data type is used to store messages proprieties.
| Field name | Type | Notes |
| ---------- | ------------- | ------------------------------- |
| Discussion | Discussion | |
| Text | text | Holds the content of a message. |
| Viewed by | List of Users | |
Order
This data type is used to store orders proprieties.
| Field name | Type | Notes |
| ------------------ | ------------- | ------------------------------------ |
| Agent | User | Stores the User data type. |
| Customer | Customer | Stores the Customer data type. |
| Date range | date range | |
| Dates | List of dates | |
| End date | date | |
| House | House | Stores the House data type. |
| Order id | number | |
| Price | number | |
| Property type | Property type | Stores the Property type option set. |
| Read | yes/no | |
| Revenue | number | |
| Schesule review id | text | |
| Start date | date | |
| Status | text | Holds an order status |
Popular filters
This data type is used to store popular filters proprieties.
| Field name | Type | Notes |
| ---------------- | --------------- | -------------------------------------- |
| Add field number | number | |
| Name | text | |
| Nr | number | |
| Text | text | |
| Type | text | |
| TYPE amenities | Other amenities | Stores the Other amenities option set. |
| TYPE Baths | number | |
| Type Beds | number | |
| TYPE garage | Garage | Stores the Garage option set. |
| TYPE parking | Parking spots | Stores the Parking spots option set. |
| TYPE property | Property type | Stores the Property type option set. |
| TYPE views | View (House) | |
| Type Year | number | |
Posts
This data type is used to store posts proprieties.
| Field name | Type | Notes |
| ---------- | ------ | -------------------------------- |
| Photo | image | Holds pictures related to a post |
| Post views | number | |
| Text | text | |
Review
This data type is used to store reviews proprieties.
| Field name | Type | Notes |
| ------------ | ------------- | ------------------------------------ |
| Agent | User | Stores the User data type. |
| Agent name | text | |
| Creator Name | text | |
| House | House | Stores the House data type. |
| Star Rating | number | |
| Status | Review status | Stores the Review status option set. |
| Text | text | |
Saved folder
This data type is used to store saved folders proprieties.
| Field name | Type | Notes |
| ---------- | -------------- | ---------------------------------- |
| Houses | List of Houses | |
| Image | image | Holds pictures related to a folder |
| Name | text | |
Schedule
This data type is used to store schedule proprieties.
| Field name | Type | Notes |
| ---------- | ------------- | ------------------------------------ |
| Agent | User | Stores the User data type. |
| Comment | text | |
| Date | date | |
| Email | text | |
| House | House | Stores the House data type. |
| Name | text | |
| Phone | text | |
| Time | Schedule time | Stores the Schedule time option set. |
Subscriber
This data type is used to store subscribers proprieties.
| Field name | Type | Notes |
| ---------- | ---- | ----- |
| User email | text | |
Users
This data type is used to store user proprieties.
| Field name | Type | Notes |
| ---------------------- | --------------------- | ------------------------------------ |
| About me | text | |
| Address | geographic address | |
| Admin | yes/no | |
| Agent | yes/no | |
| Background | Background | Stores the Background data type. |
| Birth date | date | |
| Break from | Schedule time | Stores the Schedule time option set. |
| Break to | Schedule time | Stores the Schedule time option set. |
| Content | yes/no | |
| Country | text | |
| Favorite Houses | List of Houses | |
| Firstname | text | |
| Folders | List of Saved folders | |
| Full name | text | |
| ID | number | |
| Lastname | text | |
| Logout | yes/no | |
| Logout event | text | |
| Logout event time | date | |
| My Houses | List of Houses | |
| Nr Customers | number | |
| Nr Properties | number | |
| Nr Properties rented | number | |
| Nr Properties saled | number | |
| phone | number | |
| Profile name admin | text | |
| Profile picture | image | Holds pictures related to a User |
| Rating | number | |
| Search\_city | text | |
| Search\_price\_max | number | |
| Search\_price\_min | number | |
| Search\_price\_range | numeric range | |
| Search\_property\_type | List of Property type | |
| Search\_status | Contract type | |
| Search\_text | text | |
| Work days | List of Weekdays | |
| Work from | Schedule time | Stores the Schedule time option set. |
| Work to | Schedule time | Stores the Schedule time option set. |
View
This data type is used to store views proprieties.
| | | |
| ------ | ------ | --------------------------- |
| House | House | Stores the House data type. |
| Number | number | |
### Option Sets
{% hint style="info" %}
Option sets define a static list of choices for use in dropdowns, pop-ups, etc. Options inside the sets have at least a text display, but they can have additional attributes defined in the Data tab. To learn more, see [Bubble Manual](https://manual.bubble.io/core-resources/data/operations-and-comparisons#option-sets).
{% endhint %}
Bathrooms
* 1
* 2
* 3
* 4
* 5
Bedrooms
* Studio
* 1
* 2
* 3
* 4
* 5
Contract type
* For sale
* For rent
Garage
* for 1 car
* for 2 cars
* for 3 cars
* for 4 cars
Home status
* Pending
* Rented
* Saled
Lease duration
* 1 month
* 2 months
* 3 months
* 4 months
* 5 months
* 6 months
* 7 months
* 8 months
* 9 months
* 10 months
* 11 months
* 12 months
Lot
* 1000 sqft
* 2000 sqft
* 3000 sqft
* 4000 sqft
* 5000 sqft
* 7500 sqft
* 1/4 acre
* 1/2 acre
* 1 acre
* 2 acres
* 4 acres
* 5 acres
* 10 acres
* 20 acres
* 50 acres
* 100 acres
Other aminities
* A/C
* Pool
* Waterfront
* Outdoor
Parking Spots
* 1
* 2
* 3
* 4
Payment status
* Paid
* In process
Pet policy
* No pets allowed
* Cats allowed
* Small dogs allowed
* Large dogs allowed
Property type
* Houses
* Townhouses
* Condos
* Lots
* Apartments
* Any Property Type
Publishing Status
* Published
* Pending
* Hidden
Review status
* Pending
* Published
* Hidden
* Any status
Schedule time
* 08:00
* 09:00
* 10:00
* 11:00
* 12:00
* 13:00
* 14:00
* 15:00
* 16:00
* 17:00
* 18:00
* 19:00
* 20:00
View (House)
* City
* Park
* Mountain
* Water
Weekday
* Monday
* Tuesday
* Wednesday
* Thursday
* Friday
* Saturday
* Sunday
### Paid Plugins
{% hint style="info" %}
This template is delivered "as is" and comes only with general Bubble documentation. Development assistance, support and special documentation is not included.
{% endhint %}
{% hint style="info" %}
Please reach out to us at , if you need help customizing this template. We will be happy to help you customize the template or with any other development projects. We will customize and support this template on regular terms for sales of development services.
{% endhint %}
{% hint style="info" %}
If you have questions and bugs to report, contact us by email at
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://mind-for-apps.gitbook.io/templates-documentation/master.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.