{"result":{"depiction_url":null,"edges":{"in_module":{"objects":[{"created":"2026-09-09T13:48:10Z","object_id":{"id":335,"is_a":["text","documentation","reference","module"],"name":"doc_core","title":"Zotonic Core","uri":"https:\/\/zotonic.com\/id\/335"},"seq":1}],"predicate":{"id":333,"is_a":["meta","predicate"],"name":"in_module","title":{"_type":"trans","tr":{"en":"In module"}},"uri":"https:\/\/zotonic.com\/id\/in_module"}},"references":{"objects":[{"created":"2020-05-30T05:48:08Z","object_id":{"id":1306,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_authentication","title":"mod_authentication","uri":"https:\/\/zotonic.com\/id\/1306"},"seq":1000000},{"created":"2020-05-30T05:48:08Z","object_id":{"id":1912,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_facebook","title":"mod_facebook","uri":"https:\/\/zotonic.com\/id\/1912"},"seq":1000000}],"predicate":{"id":332,"is_a":["meta","predicate"],"name":"references","title":{"_type":"trans","tr":{"en":"References"}},"uri":"https:\/\/zotonic.com\/id\/references"}},"refers":{"objects":[{"created":"2026-09-09T13:48:10Z","object_id":{"id":1306,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_authentication","title":"mod_authentication","uri":"https:\/\/zotonic.com\/id\/1306"},"seq":1000000},{"created":"2026-09-09T13:48:10Z","object_id":{"id":1912,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_facebook","title":"mod_facebook","uri":"https:\/\/zotonic.com\/id\/1912"},"seq":1000000}],"predicate":{"id":2409,"is_a":["meta","predicate"],"name":"refers","title":{"_type":"trans","tr":{"en":"Refers"}},"uri":"https:\/\/zotonic.com\/id\/refers"}},"relation":{"objects":[{"created":"2020-05-30T05:48:08Z","object_id":{"id":1536,"is_a":["text","documentation","developerguide"],"name":"doc_developerguide_access_control","title":{"_type":"trans","tr":{"en":"Keep permission checks at the boundary"}},"uri":"https:\/\/zotonic.com\/id\/1536"},"seq":1000000},{"created":"2020-05-30T05:48:08Z","object_id":{"id":1306,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_authentication","title":"mod_authentication","uri":"https:\/\/zotonic.com\/id\/1306"},"seq":1000000},{"created":"2020-05-30T05:48:08Z","object_id":{"id":1912,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_facebook","title":"mod_facebook","uri":"https:\/\/zotonic.com\/id\/1912"},"seq":1000000}],"predicate":{"id":303,"is_a":["meta","predicate"],"name":"relation","title":{"_type":"trans","tr":{"nl":"Relatie","en":"Relation"}},"uri":"http:\/\/purl.org\/dc\/terms\/relation"}},"subject":{"objects":[{"created":"2026-09-09T13:48:10Z","object_id":{"id":2555,"is_a":["categorization","keyword","keyword_information_type"],"name":"zotonic_topic_reference","title":"Reference","uri":"https:\/\/zotonic.com\/id\/2555"},"seq":1},{"created":"2026-09-09T13:48:10Z","object_id":{"id":2564,"is_a":["categorization","keyword","keyword_audience"],"name":"zotonic_topic_backend_developer","title":"Backend developer","uri":"https:\/\/zotonic.com\/id\/2564"},"seq":2},{"created":"2026-09-09T13:48:10Z","object_id":{"id":2589,"is_a":["categorization","keyword","keyword_domain"],"name":"zotonic_topic_identity_and_accounts","title":"Identity and accounts","uri":"https:\/\/zotonic.com\/id\/2589"},"seq":3},{"created":"2026-09-09T13:48:10Z","object_id":{"id":2625,"is_a":["categorization","keyword","keyword_architecture"],"name":"zotonic_topic_model","title":"Model","uri":"https:\/\/zotonic.com\/id\/2625"},"seq":4},{"created":"2026-09-09T13:48:10Z","object_id":{"id":2643,"is_a":["categorization","keyword","keyword_task"],"name":"zotonic_topic_query","title":"Query","uri":"https:\/\/zotonic.com\/id\/2643"},"seq":5},{"created":"2026-09-09T13:48:10Z","object_id":{"id":2666,"is_a":["categorization","keyword","keyword_data_type"],"name":"zotonic_topic_identifier","title":"Identifier","uri":"https:\/\/zotonic.com\/id\/2666"},"seq":6}],"predicate":{"id":308,"is_a":["meta","predicate"],"name":"subject","title":{"_type":"trans","tr":{"en":"Keyword"}},"uri":"http:\/\/purl.org\/dc\/elements\/1.1\/subject"}}},"id":1285,"is_a":["text","documentation","reference","model"],"links":[{"rel":"self","target":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1285"},{"rel":"hub","target":"https:\/\/zotonic.com\/.zotonic\/websub"}],"medium":null,"medium_url":null,"name":"doc_model_model_identity","page_url":{"en":"https:\/\/zotonic.com\/docs\/1285\/identity","x-default":"https:\/\/zotonic.com\/docs\/1285\/identity"},"preview_url":null,"resource":{"version":4027,"pivot_location_lat":null,"title":"identity","is_authoritative":true,"body":"

The m_identity model manages usernames and other user identities.\nmodule#mod_authentication<\/code><\/a> uses it to store and check salted passwords, but also provides\na safe storage for user tokens of any kind, as used by module#mod_facebook<\/code><\/a>.<\/p>\n

Note that a user does not have to be of the person category per se, in Zotonic anything can have identities attached to it.<\/p>\n

The following m_identity model properties are available in templates:<\/p>\n
Property<\/th>Description<\/th>Example value<\/th><\/tr><\/thead>
is_user<\/td>Check if a page id is a user. Return a bool. Usage: m.identity[page_id].is_user<\/td>true<\/code><\/td><\/tr>
username<\/td>Fetch the username, if any, of a user. Returns a binary or undefined. Usage: m.identity[page_id].username<\/td><<"admin">><\/code><\/td><\/tr><\/tbody><\/table>\n

Available Model API Paths<\/h2>\n
Method<\/th>Path pattern<\/th>Description<\/th><\/tr><\/thead>
get<\/code><\/td>\/lookup\/+type\/+key\/...<\/code><\/td>Return all filtered identity records matching normalized identity key +key<\/code> for identity type +type<\/code> (propb<\/code> and secret fields are stripped; admin only).<\/td><\/tr>
get<\/code><\/td>\/generate_password\/...<\/code><\/td>Return a newly generated random password string (z_ids:password\/0<\/code>).<\/td><\/tr>
get<\/code><\/td>\/is_email_verified<\/code><\/td>Return whether the current user’s primary email_raw<\/code> has a matching verified email<\/code> identity record. No further lookups.<\/td><\/tr>
get<\/code><\/td>\/is_email_verified\/+userid\/...<\/code><\/td>Return whether user +userid<\/code> has a verified identity record for its primary email_raw<\/code> address (editable by caller).<\/td><\/tr>
get<\/code><\/td>\/+id\/is_user\/...<\/code><\/td>Return whether resource +id<\/code> has at least one identity of a user-defining type (auth_identity_types<\/code>, default includes username_pw<\/code>; requires visibility).<\/td><\/tr>
get<\/code><\/td>\/+id\/username\/...<\/code><\/td>Return the current username identity key for resource +id<\/code> (requires edit permission on +id<\/code>).<\/td><\/tr>
get<\/code><\/td>\/+id\/user_info\/...<\/code><\/td>Return user info map for +id<\/code> with user_id<\/code>, username<\/code>, visited<\/code>, modified<\/code>, and is_expired<\/code>; returns empty\/default values when no username_pw<\/code> identity exists (requires edit permission).<\/td><\/tr>
get<\/code><\/td>\/+id\/logon_history\/...<\/code><\/td>Return login history rows (user_agent<\/code>, ip_address<\/code>, created<\/code>) ordered by newest first for user +id<\/code> (self or admin).<\/td><\/tr>
get<\/code><\/td>\/+id\/all_types\/...<\/code><\/td>Return all identity type<\/code> values present for user\/resource +id<\/code>; returns []<\/code> when caller cannot edit +id<\/code>.<\/td><\/tr>
get<\/code><\/td>\/+id\/all<\/code><\/td>Return all identities for user\/resource +id<\/code> as filtered identity records (admin only). No further lookups.<\/td><\/tr>
get<\/code><\/td>\/+id\/all\/email\/...<\/code><\/td>Return all filtered email<\/code> identities for user +id<\/code>; ensures the resource primary email is represented as an identity when valid (requires edit permission).<\/td><\/tr>
get<\/code><\/td>\/+id\/all\/+type\/...<\/code><\/td>Return filtered identity records of type +type<\/code> for user\/resource +id<\/code> (admin only).<\/td><\/tr>
get<\/code><\/td>\/get\/+idnid\/...<\/code><\/td>Return one filtered identity record by identity id +idnid<\/code> (admin only).<\/td><\/tr>
get<\/code><\/td>\/verify\/+idnid\/+verifykey\/...<\/code><\/td>Return identity record +idnid<\/code> only when +verifykey<\/code> matches the stored verify_key<\/code> using constant-time comparison; otherwise return undefined<\/code>.<\/td><\/tr>
get<\/code><\/td>\/+id\/+type\/...<\/code><\/td>Return identity record for type +type<\/code> on user\/resource +id<\/code> (admin only; enoent<\/code> when missing).<\/td><\/tr><\/tbody><\/table>\n

\/+name<\/code> marks a variable path segment. A trailing \/...<\/code> means extra path segments are accepted for further lookups.<\/p>","slug":"identity","is_protected":false,"visible_for":0,"tz":"UTC","language":["en"],"doc_source_hash":"0075501393efa0e21d17938f1f606de7c2eb3410a0778461f7999bb200e9be98","is_featured":false,"content_group_id":{"id":2551,"is_a":["meta","content_group"],"name":"content_group_imported_docs","title":"Imported documentation","uri":"https:\/\/zotonic.com\/id\/content_group_imported_docs"},"category_id":{"id":322,"is_a":["meta","category"],"name":"model","title":"Models","uri":"https:\/\/test.zotonic.com\/id\/322"},"doc_source_path":"apps\/zotonic_core\/src\/models\/m_identity.erl","publication_start":"2023-06-24T08:17:52Z","github_url":"https:\/\/github.com\/zotonic\/zotonic\/blob\/master\/apps\/zotonic_core\/src\/models\/m_identity.erl","pivot_location_lng":null,"doc_source_kind":"model","name":"doc_model_model_identity","is_unfindable":false,"is_published":true,"pivot_geocode":null,"created":"2020-05-30T05:47:16Z","uri":null,"doc_status":"current","is_dependent":false,"erlang_app":"zotonic_core","publication_end":"9999-06-01T00:00:00Z","modifier_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"privacy":0,"doc_source_commit":"c19e5c894d3bd01b57581e2af43e176d42c6877a\n","erlang_module":"m_identity","creator_id":{"id":336,"is_a":["person","robot"],"name":"gitbot","title":"Git","uri":"https:\/\/zotonic.com\/id\/336"},"modified":"2026-10-08T10:41:07Z","title_slug":"identity"},"uri":"https:\/\/zotonic.com\/id\/1285","uri_template":"https:\/\/zotonic.com\/id\/:id","websub":{"hub":"https:\/\/zotonic.com\/.zotonic\/websub","topic":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1285"}},"status":"ok"}