[Skip to content](#main)

[→](/)

[![Avunu](/brand/avunu-logo.svg)![Avunu](/brand/avunu-logo-light.svg)](/)[Services](/services/)[Consulting](/services/consulting/)[ERP](/services/erp/)[Odoo](/services/erp/odoo/)[ERPNext](/services/erp/erpnext/)[Custom software](/services/custom-software/)[Devices & IoT](/services/devices-iot/)[Websites](/services/websites/)[Infrastructure](/services/infrastructure/)[Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

[About Avunu](/about/)[Team](/about/team/)[Insights](/insights/)[Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

- [Services](/services/)[Consulting](/services/consulting/)
- [ERP](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)
- [Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

- [About Avunu](/about/)
- [Team](/about/team/)
- [Insights](/insights/)
- [Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

[Knowledge base](/kb/)[Frappe](/kb/frappe/)Custom Views

Search the knowledge basePress/

ESC

Jump to

[Browse the knowledge base](/kb/)[Frappe](/kb/frappe/)[ERPNext](/kb/erpnext/)[Odoo](/kb/odoo/)[WordPress](/kb/wordpress/)[NixOS](/kb/nixos/)[Email](/kb/email/)[Linux](/kb/linux/)[Databases](/kb/databases/)[Containers](/kb/containers/)[Proxmox](/kb/proxmox/)[Git & Dev Tools](/kb/git-and-dev-tools/)

↵select↑↓navigateescclose

Search the knowledge base

[Skip to the article](#kb-article)[Frappe](/kb/frappe/)20 articles

- [Overview](/kb/frappe/)
- [Bench Operations](/kb/frappe/bench-operations/)
- [Builder Page Scripts](/kb/frappe/builder-page-scripts/)
- [Client-Side Recipes](/kb/frappe/client-side-recipes/)
- [Common Query Patterns](/kb/frappe/common-query-patterns/)
- [Custom Field Controllers](/kb/frappe/custom-field-controllers/)
- [Custom Pages](/kb/frappe/custom-pages/)
- [Custom Views](/kb/frappe/custom-views/)
- [Customizations API](/kb/frappe/customizations-api/)
- [Customizing Grid Columns for Child Tables](/kb/frappe/customizing-grid-columns-child-tables/)
- [Doctype States & Status Fields](/kb/frappe/doctype-states-status-fields/)
- [Grandchild Table Fields](/kb/frappe/grandchild-table-fields/)
- [Portal Views](/kb/frappe/portal-views/)
- [Project Structure & Hooks](/kb/frappe/project-structure-hooks/)
- [Query Builder & PyPika Extensions](/kb/frappe/query-builder-pypika/)
- [Quick Entry Forms](/kb/frappe/quick-entry-forms/)
- [Script Reports](/kb/frappe/script-reports/)
- [Testing on Live Databases](/kb/frappe/testing-live-databases/)
- [Type Annotations & Controller Overrides](/kb/frappe/type-annotations-controller-overrides/)
- [Vite & TypeScript Compilation](/kb/frappe/vite-typescript-compilation/)
- [Web Forms](/kb/frappe/web-forms/)

Other sections[ERPNext](/kb/erpnext/)[Odoo](/kb/odoo/)[WordPress](/kb/wordpress/)[NixOS](/kb/nixos/)[Email](/kb/email/)[Linux](/kb/linux/)[Databases](/kb/databases/)[Containers](/kb/containers/)[Proxmox](/kb/proxmox/)[Git & Dev Tools](/kb/git-and-dev-tools/)

In Frappe: 20 articles

[Overview](/kb/frappe/)[Bench Operations](/kb/frappe/bench-operations/)[Builder Page Scripts](/kb/frappe/builder-page-scripts/)[Client-Side Recipes](/kb/frappe/client-side-recipes/)[Common Query Patterns](/kb/frappe/common-query-patterns/)[Custom Field Controllers](/kb/frappe/custom-field-controllers/)[Custom Pages](/kb/frappe/custom-pages/)[Custom Views](/kb/frappe/custom-views/)[Customizations API](/kb/frappe/customizations-api/)[Customizing Grid Columns for Child Tables](/kb/frappe/customizing-grid-columns-child-tables/)[Doctype States & Status Fields](/kb/frappe/doctype-states-status-fields/)[Grandchild Table Fields](/kb/frappe/grandchild-table-fields/)[Portal Views](/kb/frappe/portal-views/)[Project Structure & Hooks](/kb/frappe/project-structure-hooks/)[Query Builder & PyPika Extensions](/kb/frappe/query-builder-pypika/)[Quick Entry Forms](/kb/frappe/quick-entry-forms/)[Script Reports](/kb/frappe/script-reports/)[Testing on Live Databases](/kb/frappe/testing-live-databases/)[Type Annotations & Controller Overrides](/kb/frappe/type-annotations-controller-overrides/)[Vite & TypeScript Compilation](/kb/frappe/vite-typescript-compilation/)[Web Forms](/kb/frappe/web-forms/)

Other sections[ERPNext](/kb/erpnext/)[Odoo](/kb/odoo/)[WordPress](/kb/wordpress/)[NixOS](/kb/nixos/)[Email](/kb/email/)[Linux](/kb/linux/)[Databases](/kb/databases/)[Containers](/kb/containers/)[Proxmox](/kb/proxmox/)[Git & Dev Tools](/kb/git-and-dev-tools/)

FrappeCustom Views

Add new list view types or override built-in views such as the Map view with custom rendering.

UpdatedOct 1, 2026

Tagsfrappejavascriptlist-viewclient-side

Reading time5 min

On this page[Architecture Overview](#architecture-overview)[File Setup](#file-setup)[Step 1: Override ListViewSelect](#step-1-override-listviewselect)[Step 2: Register the Route](#step-2-register-the-route)[Step 3: Implement the View Class](#step-3-implement-the-view-class)[Naming Convention](#naming-convention)[Useful Methods to Override](#useful-methods-to-override)[Complete Example](#complete-example)[Overriding a Built-in View](#overriding-a-built-in-view)[Example: Custom Map View Popups](#example-custom-map-view-popups)

Add entirely new view types to Frappe's list view system or override existing views for specific doctypes. This allows replacing the default table-based list with custom interfaces (Kanban boards, card layouts, Vue apps, etc.).

## Architecture Overview

Three components work together:

**`ListViewSelect` override** — Injects new view options into the sidebar drop down

**Router registration** — Tells Frappe's router about the new view slug

**View class** — The actual rendering implementation

All three go in a single `app.bundle.js` file included globally via `hooks.py`.

## File Setup

```text
myapp/public/js/app.bundle.js
```

In `hooks.py`:

```
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">app_include_js </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"myapp.app.bundle.js"</span>
```

## Step 1: Override ListViewSelect

Add a custom view menu item for a specific doctype:

```
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">provide</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"frappe.views"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">);</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.views.MyViewSelect </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">class</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">MyViewSelect</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">extends</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">frappe</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">views</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">ListViewSelect</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">setup_views</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">() {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Call parent to get all default views</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">super</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">setup_views</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">();</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Add custom view only for a specific doctype</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> (</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.doctype </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">===</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Task"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">add_view_to_menu</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Tasks"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, () </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">set_route</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"tasks"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">));</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        }</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Add a "List" option so users can switch back</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">add_view_to_menu</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"List"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, () </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">set_route</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"List"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">));</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    }</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">};</span>

<span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Globally replace the ListViewSelect class</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.views.ListViewSelect </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.views.MyViewSelect;</span>
```

**Important:** The global replacement (`frappe.views.ListViewSelect = ...`) is necessary because Frappe instantiates `ListViewSelect` directly. There's no hook to register a custom one per doctype.

## Step 2: Register the Route

```
<span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Tell the router about the new view slug</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.router.list_views.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">push</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"tasks"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.router.list_views_route[</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"tasks"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">] </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Tasks"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">;</span>
```

The slug (`"tasks"`) maps to a view name (`"Tasks"`), which Frappe uses to look up `frappe.views.TasksView` (convention: `frappe.views.{Name}View`).

## Step 3: Implement the View Class

```
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.views.TasksView </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">class</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">TasksView</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">extends</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">frappe</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">views</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">ListView</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">setup_defaults</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">() {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">return</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">super</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">setup_defaults</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">().</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">then</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(() </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.page_title </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">__</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Tasks"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.page_name </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"tasks-view"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">;</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Custom API endpoint for data fetching</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.method </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"myapp.api.get_tasks"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">;</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        });</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    }</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Override data parsing (custom API returns different structure)</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">prepare_data</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">r</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.data </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> r.message;</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    }</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">setup_page</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">() {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">return</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">super</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">setup_page</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">().</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">then</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(() </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Fetch list settings for theming</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            frappe.model.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">with_doctype</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.doctype, () </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.list_settings </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">new</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.base_list.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">ListSettings</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.doctype);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            });</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Custom primary action</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.page.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">set_primary_action</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">__</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"New Task"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">), () </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                frappe.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">new_doc</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Task"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            }, </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"add"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        });</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    }</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Remove loading skeletons</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">show_skeleton</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">() {}</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">hide_skeleton</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">() {}</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Remove default list header</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">render_header</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">refresh_header</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">false</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.$result?.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">find</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">".list-row-head"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">).</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">remove</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">();</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    }</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Render a completely custom UI</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">render_list</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">() {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> (</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">!</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.data?.</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">length</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">render_no_result</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">();</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">return</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">;</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        }</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Clear previous content</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.$result.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">empty</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">();</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Option A: Mount a Vue component</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">const</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">container</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> document.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">createElement</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"div"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.$result[</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">0</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">].</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">appendChild</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(container);</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">const</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> { </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">createApp</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">h</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> } </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> Vue;</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">createApp</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">({</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">render</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">() {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">return</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">h</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(TaskBoard, { docs: </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.data });</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            },</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">data</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: () </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> ({ data: </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.data }),</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        }).</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">mount</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(container);</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Option B: Direct HTML rendering</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// this.$result.html(this.data.map(row => `<div>...</div>`).join(""));</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    }</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">};</span>
```

## Naming Convention

The view class must follow this pattern:

```text
Route slug: "tasks"
Route name: "Tasks"  (in frappe.router.list_views_route)
Class name: frappe.views.TasksView  (frappe.views.{Name}View)
```

## Useful Methods to Override

| Method                                | Purpose                             |
| ------------------------------------- | ----------------------------------- |
| `setup_defaults()`                    | Set page title, method, page_name   |
| `prepare_data(r)`                     | Parse API response into `this.data` |
| `setup_page()`                        | Configure page actions, sidebar     |
| `render_header()`                     | Customize or remove the header row  |
| `render_list()`                       | Main rendering logic                |
| `show_skeleton()` / `hide_skeleton()` | Loading state (often disabled)      |
| `get_args()`                          | Customize API call arguments        |

## Complete Example

```
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">provide</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"frappe.views"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">provide</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"frappe.ui.toolbar"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">);</span>

<span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// 1. Override ListViewSelect</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.views.TaskViewSelect </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">class</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">TaskViewSelect</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">extends</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">frappe</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">views</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">ListViewSelect</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">setup_views</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">() {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">super</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">setup_views</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">();</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> (</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.doctype </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">===</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Task"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">add_view_to_menu</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Tasks"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, () </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">set_route</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"tasks"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">));</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        }</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">add_view_to_menu</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"List"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, () </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">set_route</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"List"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">));</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    }</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">};</span>

<span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// 2. Register route</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.router.list_views.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">push</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"tasks"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.router.list_views_route[</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"tasks"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">] </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Tasks"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">;</span>

<span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// 3. Implement view</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.views.TasksView </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">class</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">TasksView</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">extends</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">frappe</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">views</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">ListView</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">prepare_data</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">r</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) { </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.data </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> r.message; }</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">setup_defaults</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">() {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">return</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">super</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">setup_defaults</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">().</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">then</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(() </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.page_title </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">__</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Tasks"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.method </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"myapp.api.get_tasks"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">;</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        });</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    }</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">show_skeleton</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">() {}</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">hide_skeleton</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">() {}</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">render_header</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">() { </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.$result?.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">find</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">".list-row-head"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">).</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">remove</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(); }</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">render_list</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">() {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Custom rendering here</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    }</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">};</span>

<span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// 4. Global override</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.views.ListViewSelect </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.views.TaskViewSelect;</span>
```

## Overriding a Built-in View

You don't always need a new view type. To change how an existing view behaves (Map, Kanban, Calendar, and so on), subclass it and assign the subclass back to the same name. `frappe.views.ListFactory` looks the class up by name (`frappe.views[view_name + "View"]`) each time the route is opened, so the replacement takes effect everywhere without touching the router.

Put the override in the same globally included `app.bundle.js`, and limit the changes to the doctypes you care about so other doctypes keep the stock behavior.

### Example: Custom Map View Popups

The Map view shows each record as a marker whose popup links to the document by name. This override shows a more useful label for one doctype.

Frappe v16 exposes small hook methods for this, so you only override what you need:

```
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.views.CustomMapView </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">class</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">CustomMapView</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">extends</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">frappe</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">views</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">MapView</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">setup_defaults</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">() {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">super</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">setup_defaults</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">();</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> (</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.doctype </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">===</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"<DOCTYPE>"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Make sure the label field is fetched with the list data</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">_add_field</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"<LABEL_FIELD>"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        }</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    }</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_feature_properties</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">row</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">return</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> { </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">...</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">super</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_feature_properties</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(row), label: row.</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E"><</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">LABEL_FIELD</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> };</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    }</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_popup_content</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">feature</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">const</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> { </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">name</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">label</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> } </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> feature.properties;</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> (</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">!</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">label) </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">return</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">super</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_popup_content</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(feature);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">return</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.utils.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_form_link</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.doctype, name, </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">true</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, frappe.utils.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">escape_html</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(label));</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    }</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">};</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.views.MapView </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.views.CustomMapView;</span>
```

In Frappe v15, the Map view builds its markers in a single `get_coords()` call and always labels popups with the document name, so `get_coords()` is the method to override. Use it to control which records and coordinates are mapped. This version reads latitude and longitude fields directly and loads every record that matches the current filters:

```
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.views.CustomMapView </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">class</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">CustomMapView</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">extends</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">frappe</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">views</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">MapView</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_coords</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">() {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> (</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.doctype </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">!==</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"<DOCTYPE>"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">return</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">super</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_coords</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">();</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">return</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.db</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            .</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_list</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.doctype, {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                fields: [</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"name"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"latitude"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"longitude"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">],</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                filters: </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_filters_for_args</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(),</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                limit: </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">0</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// no limit</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            })</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            .</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">then</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">((</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">rows</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.coords </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                    type: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"FeatureCollection"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                    features: rows</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                        .</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">filter</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">((</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">row</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> row.latitude </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">&&</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> row.longitude)</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                        .</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">map</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">((</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">row</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> ({</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                            type: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Feature"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                            properties: { name: row.name },</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                            geometry: {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                                type: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Point"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                                </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// GeoJSON order is [longitude, latitude]</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                                coordinates: [</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">parseFloat</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(row.longitude), </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">parseFloat</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(row.latitude)],</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                            },</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                        })),</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                };</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            });</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    }</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">};</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.views.MapView </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.views.CustomMapView;</span>
```

**Important:** Built-in views change between major versions (the v15 and v16 Map views share almost no method names). Re-check every override against the new source when you upgrade, and always fall back to `super` for doctypes you aren't customizing.

Sources

- [github.com/frappe/frappe/blob/version-16/frappe/public/js/frappe/views/map/map_view.js](https://github.com/frappe/frappe/blob/version-16/frappe/public/js/frappe/views/map/map_view.js)
- [github.com/frappe/frappe/blob/version-16/frappe/public/js/frappe/list/list_factory.js](https://github.com/frappe/frappe/blob/version-16/frappe/public/js/frappe/list/list_factory.js)

Need help with Frappe?

Our notes can take you a long way, but sometimes you'd rather have someone who's done it before.

[ERPNext implementation](/services/erp/erpnext/)

[← PreviousCustom Pages](/kb/frappe/custom-pages/)[Next →Customizations API](/kb/frappe/customizations-api/)

CC0This article is in the public domain ([CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/)), code samples included. Use it however helps you.

On this page

- [Architecture Overview](#architecture-overview)
- [File Setup](#file-setup)
- [Step 1: Override ListViewSelect](#step-1-override-listviewselect)
- [Step 2: Register the Route](#step-2-register-the-route)
- [Step 3: Implement the View Class](#step-3-implement-the-view-class)
- [Naming Convention](#naming-convention)
- [Useful Methods to Override](#useful-methods-to-override)
- [Complete Example](#complete-example)
- [Overriding a Built-in View](#overriding-a-built-in-view)
- [Example: Custom Map View Popups](#example-custom-map-view-popups)

[Back to top↑](#top)

Services

- [ERP implementation](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)

Resources

- [Our work](/work/)
- [Open source](/open-source/)
- [Knowledge base](/kb/)
- [Insights](/insights/)

Company

- [About](/about/)
- [Team](/about/team/)
- [Partners](/partners/)
- [Contact](/contact/)

Clients

- [Project portal](https://erp.avunu.net/projects)
- [Invoices](https://erp.avunu.net/)
- [Support](https://erp.avunu.net/)

[![Avunu](/brand/avunu-logo-light.svg)](/)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M20.400 20.500h-3.600v-5.600c0-1.300 0-3-1.800-3s-2.100 1.400-2.100 2.900v5.700H9.400V9h3.400v1.600c.5-.9 1.600-1.900 3.400-1.900 3.600 0 4.300 2.400 4.300 5.500v6.300zM5.300 7.400a2.100 2.100 0 1 1 0-4.100 2.100 2.100 0 0 1 0 4.100zm1.800 13.100H3.600V9h3.500v11.500zM22.200 0H1.800C.8 0 0 .8 0 1.700v20.600c0 .9.800 1.700 1.800 1.700h20.400c1 0 1.800-.8 1.800-1.700V1.700C24 .8 23.200 0 22.200 0z">\</path>\</svg>\</av-icon>](https://www.linkedin.com/company/avunu)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M12 .3a12 12 0 0 0-3.8 23.4c.6.1.8-.3.8-.6v-2c-3.3.7-4-1.6-4-1.6-.6-1.4-1.4-1.8-1.4-1.8-1-.7.1-.7.1-.7 1.2.1 1.8 1.2 1.8 1.2 1 1.8 2.8 1.3 3.5 1 .1-.8.4-1.3.7-1.6-2.7-.3-5.5-1.3-5.5-5.9 0-1.3.5-2.4 1.2-3.2-.1-.3-.5-1.5.1-3.2 0 0 1-.3 3.3 1.2a11.500 11.500 0 0 1 6 0c2.300-1.500 3.300-1.200 3.300-1.200.6 1.700.2 2.900.1 3.200.8.8 1.200 1.900 1.200 3.200 0 4.600-2.800 5.600-5.500 5.900.4.400.8 1.100.8 2.200v3.300c0 .3.2.7.8.6A12 12 0 0 0 12 .3">\</path>\</svg>\</av-icon>](https://github.com/Avunu)[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

Avunu LLC · 948 East Philadelphia Street, York, PA 17403 · (717) 814-8540Knowledge base articles are in the public domain[Privacy](/privacy/)[Terms](/terms/)
