{"result":{"depiction_url":null,"edges":{"in_module":{"objects":[{"created":"2026-09-09T13:48:11Z","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"}},"subject":{"objects":[{"created":"2026-09-09T13:48:11Z","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:11Z","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:11Z","object_id":{"id":2576,"is_a":["categorization","keyword","keyword_domain"],"name":"zotonic_topic_media_management","title":"Media management","uri":"https:\/\/zotonic.com\/id\/2576"},"seq":3},{"created":"2026-09-09T13:48:11Z","object_id":{"id":2619,"is_a":["categorization","keyword","keyword_architecture"],"name":"zotonic_topic_media_resource","title":"Media resource","uri":"https:\/\/zotonic.com\/id\/2619"},"seq":4},{"created":"2026-09-09T13:48:11Z","object_id":{"id":2625,"is_a":["categorization","keyword","keyword_architecture"],"name":"zotonic_topic_model","title":"Model","uri":"https:\/\/zotonic.com\/id\/2625"},"seq":5},{"created":"2026-09-09T13:48:11Z","object_id":{"id":2643,"is_a":["categorization","keyword","keyword_task"],"name":"zotonic_topic_query","title":"Query","uri":"https:\/\/zotonic.com\/id\/2643"},"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":1284,"is_a":["text","documentation","reference","model"],"links":[{"rel":"self","target":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1284"},{"rel":"hub","target":"https:\/\/zotonic.com\/.zotonic\/websub"}],"medium":null,"medium_url":null,"name":"doc_model_model_media","page_url":{"en":"https:\/\/zotonic.com\/docs\/1284\/media","x-default":"https:\/\/zotonic.com\/docs\/1284\/media"},"preview_url":null,"resource":{"version":3976,"pivot_location_lat":null,"title":"media","is_authoritative":true,"body":"

Access to data about uploaded files and other media.<\/p>\n

The medium<\/code> (singular form of media) table stores all information of uploaded files or other media. Every resource can\ncontain a single medium. A resource with a medium is most often of the category image, audio, video or document.<\/p>\n

In template the m_media<\/code> model is used to fetch the medium record by the resource id: m.media[id]<\/code>. This is the same\nfunction as with m.rsc[id].medium<\/code> except, that the m_rsc model does access control checks and the m_media does not.<\/p>\n

The m_media<\/code> model implements all functions to handle media files and is used by other Erlang modules.<\/p>\n

Properties of a medium record<\/h2>\n

A medium record has minimally the following properties, other properties can be added by modules.<\/p>\n
Property<\/th>Description<\/th>Example value<\/th><\/tr><\/thead>
id<\/td>Id of the medium record, equal to the page id.<\/td>512<\/code><\/td><\/tr>
filename<\/td>Filename and path of the uploaded file, relative to the archive directory.<\/td><<"2009\/10\/20\/zotonic-datamodel.jpg">><\/code><\/td><\/tr>
rootname<\/td>Root name of the filename.<\/td><<"zotonic-datamodel">><\/code><\/td><\/tr>
original_filename<\/td>Filename as suggested by the user agent when uploading the file. Can contain illegal characters.<\/td><<"Zotonic-datamodel.jpg">><\/code><\/td><\/tr>
mime<\/td>Mime type of the medium.<\/td><<"image\/jpeg">><\/code><\/td><\/tr>
width<\/td>Width in pixels.<\/td>536<\/code><\/td><\/tr>
height<\/td>Height in pixels.<\/td>737<\/code><\/td><\/tr>
orientation<\/td>Exif oritentation of the image.<\/td>1<\/code><\/td><\/tr>
sha1<\/td>Optional sha1 checksum of uploaded file. Undefined when not present.<\/td><\/td><\/tr>
size<\/td>Size in bytes of the uploaded file.<\/td>71585<\/code><\/td><\/tr>
preview_filename<\/td>Optional filename for a generated file preview.<\/td><\/td><\/tr>
preview_width<\/td>Optional. Width of the generated preview.<\/td><\/td><\/tr>
preview_height<\/td>Optional. Height of the generated preview.<\/td><\/td><\/tr>
is_deletable_file<\/td>If the file should be deleted when the medium record is deleted. A boolean.<\/td>true<\/code><\/td><\/tr>
is_deletable_preview<\/td>If the optionally generated preview file should be deleted when the medium record is deleted. A boolean.<\/td>false<\/code><\/td><\/tr>
created<\/td>Timestamp when the medium record is created.<\/td>{{2009,10,20},{13,47,27}}<\/code><\/td><\/tr><\/tbody><\/table>\n

Available Model API Paths<\/h2>\n
Method<\/th>Path pattern<\/th>Description<\/th><\/tr><\/thead>
get<\/code><\/td>\/+id\/...<\/code><\/td>Return medium record for resource +id<\/code> when the resource is visible; returns enoent<\/code> for unknown resource and eacces<\/code> when not visible.<\/td><\/tr>
post<\/code><\/td>\/+id<\/code><\/td>Replace medium of existing resource +id<\/code> from payload url<\/code> or uploaded file<\/code> (#upload<\/code>); optional payload rsc<\/code> map updates resource props. No further lookups.<\/td><\/tr>
post<\/code><\/td>\/<\/code><\/td>Create a new resource+medium from payload url<\/code> or uploaded file<\/code> (#upload<\/code>), with optional payload rsc<\/code> properties for the new resource. No further lookups.<\/td><\/tr>
delete<\/code><\/td>\/+id<\/code><\/td>Delete medium linked to resource +id<\/code> (queues file cleanup, emits media events); requires editable resource access. No further lookups.<\/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":"media","is_protected":false,"visible_for":0,"tz":"UTC","language":["en"],"doc_source_hash":"a7155304961fd14e21af901779f1a3348a3ac4ce163db9568a83e58c85ea1dd3","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_media.erl","publication_start":"2023-06-24T08:17:58Z","github_url":"https:\/\/github.com\/zotonic\/zotonic\/blob\/master\/apps\/zotonic_core\/src\/models\/m_media.erl","pivot_location_lng":null,"doc_source_kind":"model","name":"doc_model_model_media","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":"85498256abd162b9bc082d43a90c995844fd4408\n","erlang_module":"m_media","creator_id":{"id":336,"is_a":["person","robot"],"name":"gitbot","title":"Git","uri":"https:\/\/zotonic.com\/id\/336"},"modified":"2026-09-29T14:40:26Z","title_slug":"media"},"uri":"https:\/\/zotonic.com\/id\/1284","uri_template":"https:\/\/zotonic.com\/id\/:id","websub":{"hub":"https:\/\/zotonic.com\/.zotonic\/websub","topic":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1284"}},"status":"ok"}