Odoo 19.0 Community · Persistent

website.visitor: fields, relations and API

The website.visitor model ("Website Visitor") is a persistent model declared by the Website module, then extended by 7 other modules. It exposes 41 fields, 36 of them declared directly on the model; 6 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: website.visitor
Label: Website Visitor
Type: Persistent (models.Model)
SQL table: website_visitor
Origin module: Website (website)
Extended by: website_event, website_event_track, website_sale, website_crm, website_livechat, website_sms, website_crm_sms
Default order (_order): id DESC

Model fields

36 own fields, 0 inherited from mixins and 5 automatic ORM fields. Click a name to get a direct link to that field.

Hide inherited fields

41 of 41 fields shown

Technical name	Label	Type	Details
access_token	Access Token	`char`	required
country_flag	Country Flag	`char`	related: `country_id.image_url`
country_id	Country	`many2one` → res.country	read-only
create_date	First Connection	`datetime`	read-only
discuss_channel_ids	Visitor's livechat channels	`one2many` → discuss.channel	read-only inverse: `livechat_visitor_id` added by Website Live Chat (`website_livechat`)
email	Email	`char`	computed
event_registered_ids	Registered Events	`many2many` → event.event	computed added by Events (`website_event`)
event_registration_count	# Registrations	`integer`	computed added by Events (`website_event`)
event_registration_ids	Event Registrations	`one2many` → event.registration	inverse: `visitor_id` added by Events (`website_event`)
event_track_visitor_ids	Track Visitors	`one2many` → event.track.visitor	inverse: `visitor_id` added by Advanced Events (`website_event_track`)
event_track_wishlisted_count	# Wishlisted	`integer`	computed added by Advanced Events (`website_event_track`)
event_track_wishlisted_ids	Wishlisted Tracks	`many2many` → event.track	computed added by Advanced Events (`website_event_track`)
is_connected	Is connected? A visitor is considered as connected if his last page view was within the last 5 minutes.	`boolean`	computed
lang_id	Language Language from the website when visitor has been created	`many2one` → res.lang
last_connection_datetime	Last Connection Last page view date	`datetime`	read-only
last_visited_page_id	Last Visited Page	`many2one` → website.page	computed
lead_count	# Leads	`integer`	computed added by Contact Form (`website_crm`)
lead_ids	Leads	`many2many` → crm.lead	added by Contact Form (`website_crm`)
livechat_operator_id	Speaking with	`many2one` → res.partner	computed, stored added by Website Live Chat (`website_livechat`)
livechat_operator_name	Operator Name	`char`	related: `livechat_operator_id.name` added by Website Live Chat (`website_livechat`)
mobile	Mobile	`char`	computed
name	Name	`char`	related: `partner_id.name`
page_count	# Visited Pages Total number of tracked page visited	`integer`	computed
page_ids	Visited Pages	`many2many` → website.page	computed
partner_id	Contact Partner of the last logged in user.	`many2one` → res.partner	computed, stored
partner_image	Partner Image	`binary`	related: `partner_id.image_1920`
product_count	Products Views Total number of product viewed	`integer`	computed added by eCommerce (`website_sale`)
product_ids	Visited Products	`many2many` → product.product	computed added by eCommerce (`website_sale`)
session_count	# Sessions	`integer`	computed added by Website Live Chat (`website_livechat`)
time_since_last_action	Last action Time since last page view. E.g.: 2 minutes ago	`char`	computed
timezone	Timezone	`selection`	Values computed at runtime
visit_count	# Visits A new visit is considered if last connection was more than 8 hours ago.	`integer`	read-only
visitor_page_count	Page Views Total number of visits on tracked pages	`integer`	computed
visitor_product_count	Product Views Total number of views on products	`integer`	computed added by eCommerce (`website_sale`)
website_id	Website	`many2one` → website	read-only
website_track_ids	Visited Pages History	`one2many` → website.track	read-only inverse: `visitor_id`
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

crm.lead: lead_ids
discuss.channel: discuss_channel_ids
event.event: event_registered_ids
event.registration: event_registration_ids
event.track: event_track_wishlisted_ids
event.track.visitor: event_track_visitor_ids
product.product: product_ids
res.country: country_id
res.lang: lang_id
res.partner: livechat_operator_id, partner_id
website: website_id
website.page: last_visited_page_id, page_ids
website.track: website_track_ids

Fields of other models pointing here

crm.lead: visitor_ids
discuss.channel: livechat_visitor_id
event.registration: visitor_id
event.track: wishlist_visitor_ids
event.track.visitor: visitor_id
website.track: visitor_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/website.visitor/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: your-db" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","access_token","country_id","lang_id","livechat_operator_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}/website.visitor/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","access_token","country_id","lang_id","livechat_operator_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/website-visitor">website.visitor (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.