ir.model.fields: fields, relations and API
The ir.model.fields model ("Fields") is a persistent model declared by the Base module, then extended by 3 other modules. It exposes 51 fields, 45 of them declared directly on the model; 21 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.
Model identity
- Technical name
ir.model.fields- Label
- Fields
- Type
- Persistent (models.Model)
- SQL table
ir_model_fields- Origin module
- Base (
base) - Extended by
- mail, base_sparse_field, website
- Default order (_order)
name, id- Display field (_rec_name)
field_description
Model fields
45 own fields, 0 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.
51 of 51 fields shown
| Technical name | Label | Type | Details |
|---|---|---|---|
| column1 | Column 1 Column referring to the record in the model table | char | |
| column2 | Column 2 Column referring to the record in the comodel table | char | |
| company_dependent | Company Dependent Whether values for this field is company dependent | boolean | read-only |
| compute | Compute Code to compute the value of the field. Iterate on the recordset 'self' and assign the field's value: for record in self: record['size'] = len(record.name) Modules time, datetime, dateutil are available. | text | |
| copied | Copied Whether the value is copied when duplicating a record. | boolean | computed, stored |
| currency_field | Currency field Name of the Many2one field holding the res.currency | char | |
| depends | Dependencies Dependencies of compute method; a list of comma-separated field names, like name, partner_id.name | char | |
| domain | Domain The optional domain to restrict possible values for relationship fields, specified as a Python expression defining a list of triplets. For example: [('color','=','red')] | char | |
| field_description | Field Label | char | requiredtranslatable |
| group_expand | Expand Groups If checked, all the records of the target model will be included in a grouped result (e.g. 'Group By' filters, Kanban columns, etc.). Note that it can significantly reduce performance if the target model of the field contains a lot of records; usually used on models with few records (e.g. Stages, Job Positions, Event Types, etc.). | boolean | |
| groups | Groups | many2many | |
| help | Field Help | text | translatable |
| index | Indexed | boolean | |
| model | Model Name The technical name of the model this field belongs to | char | required |
| model_id | Model The model this field belongs to | many2one→ ir.model | required |
| modules | In Apps List of modules in which the field is defined | char | computed |
| name | Field Name | char | required |
| on_delete | On Delete On delete property for many2one fields | selection | Values: |
| readonly | Readonly | boolean | |
| related | Related Field Definition The corresponding related field, if any. This must be a dot-separated list of field names. | char | |
| related_field_id | Related Field | many2one | computed, stored |
| relation | Related Model For relationship fields, the technical name of the target model | char | |
| relation_field | Relation Field For one2many fields, the field on the target model that implement the opposite many2one relationship | char | |
| relation_field_id | Relation field | many2one | computed, stored |
| relation_table | Relation Table Used for custom many2many fields to define a custom relation table name | char | |
| required | Required | boolean | |
| sanitize | Sanitize HTML | boolean | |
| sanitize_attributes | Sanitize HTML Attributes | boolean | |
| sanitize_form | Sanitize HTML Form | boolean | |
| sanitize_overridable | Sanitize HTML overridable | boolean | |
| sanitize_style | Sanitize HTML Style | boolean | |
| sanitize_tags | Sanitize HTML Tags | boolean | |
| selectable | Selectable | boolean | |
| selection | Selection Options (Deprecated) | char | computed |
| selection_ids | Selection Options | one2many | inverse: |
| serialization_field_id | Serialization Field If set, this field will be stored in the sparse structure of the serialization field, instead of having its own database column. This cannot be changed after creation. | many2one | added by Sparse Fields ( |
| size | Size | integer | |
| state | Type | selection | requiredread-only Values: |
| store | Stored Whether the value is stored in the database. | boolean | |
| strip_classes | Strip Class Attribute | boolean | |
| strip_style | Strip Style Attribute | boolean | |
| tracking | Enable Ordered Tracking If set every modification done to this field is tracked. Value is used to order tracking values. | integer | added by Discuss ( |
| translate | Translatable Whether values for this field can be translated (enables the translation mechanism for that field) | selection | Values: |
| ttype | Field Type | selection | required Values computed at runtime |
| website_form_blacklisted | Blacklisted in web forms Blacklist this field for web forms | boolean | added by Website ( |
| create_date | Created on | datetime | read-onlyautomatic |
| create_uid | Created by | many2one | 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 | read-onlyautomatic |
Relations
Models linked from this model
- ir.model: model_id
- ir.model.fields: related_field_id, relation_field_id, serialization_field_id
- ir.model.fields.selection: selection_ids
- res.groups: groups
Fields of other models pointing here
- base.automation: on_change_field_ids, trg_date_id, trigger_field_ids
- crm.lead.scoring.frequency.field: field_id
- data_recycle.model: time_field_id
- gamification.goal.definition: batch_distinctive_field, field_date_id, field_id
- ir.actions.server: link_field_id, update_field_id, webhook_field_ids
- ir.default: field_id
- ir.model: website_form_default_field_id
- ir.model.fields: related_field_id, relation_field_id, serialization_field_id
- ir.model.fields.selection: field_id
- ir.model.inherit: parent_field_id
- mail.tracking.value: field_id
- properties.base.definition: properties_field_id
- website.sale.extra.field: field_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 -X POST "https://your-instance.odoo.com/json/2/ir.model.fields/search_read" \
-H "Authorization: bearer $ODOO_API_KEY" \
-H "X-Odoo-Database: your-db" \
-H "Content-Type: application/json" \
-d '{"domain":[],"fields":["field_description","model","model_id","name","state"],"limit":5}'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.model.fields/search_read",
headers=headers,
json={"domain": [], "fields": ["field_description","model","model_id","name","state"], "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-model-fields">ir.model.fields (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.