Odoo 19.0 Community · Persistent

ir.actions.act_window: fields, relations and API

The ir.actions.act_window model ("Action Window") is a persistent model declared by the Base module. It exposes 31 fields, 18 of them declared directly on the model; 7 fields from other models point to it. Below you will find every field with its technical name, type, label and relations, followed by an Odoo 19 JSON-2 API call.

View source code Search another model

Model identity

Technical name: ir.actions.act_window
Label: Action Window
Type: Persistent (models.Model)
SQL table: ir_act_window
Origin module: Base (base)
Default order (_order): name, id
Inherits from (mixins): ir.actions.actions

Model fields

18 own fields, 7 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.

Hide inherited fields

31 of 31 fields shown

Technical name	Label	Type	Details
cache	Data Caching If enabled, this action will cache the related data used in list, Kanban and form views with the aim to increase the loading speed	`boolean`
context	Context Value Context dictionary as Python expression, empty by default (Default: {})	`char`	required
domain	Domain Value Optional domain filtering of the destination data, as a Python expression	`char`
embedded_action_ids	Embedded Action	`one2many` → ir.embedded.actions	computed
filter	Filter	`boolean`
group_ids	Groups	`many2many` → res.groups
limit	Limit Default limit for the list view	`integer`
mobile_view_mode	Mobile View Mode First view mode in mobile and small screen environments (default='kanban'). If it can't be found among available view modes, the same mode as for wider screens is used)	`char`
res_id	Record ID Database ID of record to open in form view, when ``view_mode`` is set to 'form' only	`integer`
res_model	Destination Model Model name of the object to open in the view window	`char`	required
search_view_id	Search View Ref.	`many2one` → ir.ui.view
target	Target Window	`selection`	Values: `current` (Current Window), `new` (New Window), `fullscreen` (Full Screen), `main` (Main action of Current Window)
type	Type	`char`
usage	Action Usage Used to filter menu and home actions from the user form.	`char`
view_id	View Ref.	`many2one` → ir.ui.view
view_ids	No of Views	`one2many` → ir.actions.act_window.view	inverse: `act_window_id`
view_mode	View Mode Comma-separated list of allowed view modes, such as 'form', 'list', 'calendar', etc. (Default: list,form)	`char`	required
views	Views This function field computes the ordered list of views that should be enabled when displaying the result of an action, federating view mode, views and reference view. The result is returned as an ordered list of pairs (view_id,view_mode).	`binary`	computed
binding_model_id	Binding Model Setting a value makes this action available in the sidebar for the given model.	`many2one` → ir.model	inherited from ir.actions.actions
binding_type	Binding Type	`selection`	required Values: `action` (Action), `report` (Report) inherited from ir.actions.actions
binding_view_types	Binding View Types	`char`	inherited from ir.actions.actions
help	Action Description Optional help text for the users with a description of the target view, such as its usage and purpose.	`html`	translatable inherited from ir.actions.actions
name	Action Name	`char`	requiredtranslatable inherited from ir.actions.actions
path	Path to show in the URL	`char`	inherited from ir.actions.actions
xml_id	External ID	`char`	computed inherited from ir.actions.actions
create_date	Created on	`datetime`	read-onlyautomatic
create_uid	Created by	`many2one` → res.users	read-onlyautomatic
display_name	Display Name	`char`	read-onlycomputedautomatic
id	ID	`integer`	read-onlyautomatic
write_date	Last Updated on	`datetime`	read-onlyautomatic
write_uid	Last Updated by	`many2one` → res.users	read-onlyautomatic

Relations

Models linked from this model

ir.actions.act_window.view: view_ids
ir.embedded.actions: embedded_action_ids
ir.ui.view: search_view_id, view_id
res.groups: group_ids

Fields of other models pointing here

account.report.column: custom_audit_action_id
gamification.goal.definition: action_id
ir.actions.act_window.view: act_window_id
ir.embedded.actions: parent_action_id
mail.template: ref_ir_act_window
res.users.settings.embedded.action: action_id
sms.template: sidebar_action_id

Reading this model through the API

Odoo 19 JSON-2 API call reading the first five records with real fields of the model. Replace the instance, database and API key with your own.

curl

curl -X POST "https://your-instance.odoo.com/json/2/ir.actions.act_window/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: your-db" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","context","res_model","view_mode","search_view_id"],"limit":5}'

Python (requests)

import requests

BASE_URL = "https://your-instance.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "your-db"}

res = requests.post(
    f"{BASE_URL}/ir.actions.act_window/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","context","res_model","view_mode","search_view_id"], "limit": 5},
)
res.raise_for_status()
print(res.json())

External API access requires Odoo's Custom plan.
XML-RPC and JSON-RPC will be removed in Odoo 22 (fall 2028): use JSON-2.
The access rights and record rules of the key's user apply.

Cite this tool

Writing a tutorial, internal documentation or a forum answer? Copy this link to send your readers to the up-to-date reference.

<a href="https://aidoo.ai/en/outils/explorateur-modeles-odoo/ir-actions-act_window">ir.actions.act_window (Odoo 19.0)</a>

Sources

Data verified on September 23, 2026 · Odoo 19.0 Community

Have an Odoo project, or want to put your ERP to work with AI? Let's talk

Implementation, custom module development, connecting Claude or ChatGPT to your data: tell us about your context and we will reply within 24 business hours.