{"result":{"depiction_url":null,"edges":{"in_module":{"objects":[{"created":"2026-09-09T13:48:12Z","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:47:35Z","object_id":{"id":1728,"is_a":["text","documentation","reference"],"name":"doc_developerguide_configuration_site_configuration","title":"Site configuration","uri":"https:\/\/zotonic.com\/id\/1728"},"seq":1000000},{"created":"2020-05-30T05:47:35Z","object_id":{"id":1729,"is_a":["text","documentation","reference","model"],"name":"doc_model_model_config","title":"config","uri":"https:\/\/zotonic.com\/id\/1729"},"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:12Z","object_id":{"id":1729,"is_a":["text","documentation","reference","model"],"name":"doc_model_model_config","title":"config","uri":"https:\/\/zotonic.com\/id\/1729"},"seq":1000000}],"predicate":{"id":2409,"is_a":["meta","predicate"],"name":"refers","title":{"_type":"trans","tr":{"en":"Refers"}},"uri":"https:\/\/zotonic.com\/id\/refers"}},"subject":{"objects":[{"created":"2026-09-09T13:48:12Z","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:12Z","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:12Z","object_id":{"id":2603,"is_a":["categorization","keyword","keyword_domain"],"name":"zotonic_topic_configuration","title":"Configuration","uri":"https:\/\/zotonic.com\/id\/2603"},"seq":3},{"created":"2026-09-09T13:48:12Z","object_id":{"id":2605,"is_a":["categorization","keyword","keyword_domain"],"name":"zotonic_topic_site_management","title":"Site management","uri":"https:\/\/zotonic.com\/id\/2605"},"seq":4},{"created":"2026-09-09T13:48:12Z","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:12Z","object_id":{"id":2634,"is_a":["categorization","keyword","keyword_architecture"],"name":"zotonic_topic_site","title":"Site","uri":"https:\/\/zotonic.com\/id\/2634"},"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":1768,"is_a":["text","documentation","reference","model"],"links":[{"rel":"self","target":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1768"},{"rel":"hub","target":"https:\/\/zotonic.com\/.zotonic\/websub"}],"medium":null,"medium_url":null,"name":"doc_model_model_site","page_url":{"en":"https:\/\/zotonic.com\/docs\/1768\/site","x-default":"https:\/\/zotonic.com\/docs\/1768\/site"},"preview_url":null,"resource":{"version":3329,"pivot_location_lat":null,"title":"site","is_authoritative":true,"body":"

Retrieve information that is stored in the site\nconfiguration<\/a>. If you want to query\nvalues from the config table instead, you should use model#config<\/code><\/a>.<\/p>\n

Note<\/p>

In general the site configurarion is only accessible via the m.site<\/code> template model for users with administrator\nrights. Exceptions are keys starting with public<\/code> or {{ m.site.title }}<\/code>, hostname configurations and the paglen<\/em>.<\/p><\/div>\n

Fetch a site configuration key<\/h2>\n

Example, fetching the site configuration key "hostname":<\/p>\n

{{ m.site.hostname }}\n<\/code><\/pre>\n
Fetching all configurations<\/h2>\n
It is easy to loop over all site configurations:<\/p>\n
{% for key, value in m.site %}\n  {{ key }} -- {{ value }} <br>\n{% endfor %}\n<\/code><\/pre>\n
Overriding config values<\/h2>\n
Zotonic has two places where a site's configuration is kept. One is in the site's config files, the other in the\nconfig table. The config table (accessible through model#config<\/code><\/a>) overrules any module\nsettings from the config file, for rows where the module key of the config value is set to site.<\/p>\n
Within the site configuration, you can override module-specific configuration: Module configurations are defined with a\nproperty key equal to the module name, with a property list as value. For example:<\/p>\n
{mod_foo, [ {hostname, "localhost"} ]}\n<\/code><\/pre>\n
will put the default "hostname" setting of the imaginary mod_foo<\/code> module to localhost<\/code>.<\/p>\n
Default config values<\/h2>\n
Sites have the following default config settings:<\/p>\n
Property<\/th>Description<\/th>Example value<\/th><\/tr><\/thead>
environment<\/td>Set the DTAP status of the site. Can be one of production, development, test, acceptance, education or backup. Default: production<\/td>development<\/code><\/td><\/tr>
hostname<\/td>The hostname of the site<\/td>example.com<\/code><\/td><\/tr>
title<\/td>The title of the site.<\/td>"My Awesome Blog"<\/code><\/td><\/tr>
protocol<\/td>The main protocol of the site. Used to construct urls. Default "http".<\/td>"https"<\/code><\/td><\/tr>
document_domain<\/td>The document domain used for cross domain iframe javascripts. Default is the same as the cookie_domain.<\/td>www.example.com<\/code><\/td><\/tr>
cookie_domain<\/td>The domain to use on cookies. This defaults to undefined, which will equal the domain of the current request.<\/td>.example.com<\/code><\/td><\/tr>
session_expire_inactive<\/td>User inactivity timeout after seeing that the user has not been active. Default: 14400 (4 hours)<\/td>3600 (1 hour)<\/code><\/td><\/tr>
autologon_expire<\/td>Auto logon cookie timeout setting. Default: 15552000 (3 months)<\/td>31536000 (365 days)<\/code><\/td><\/tr>
site<\/td>The name of the site, an atom.<\/td>wwwzotonic.<\/code><\/td><\/tr>
hsts<\/td>Indicate if the site should use Strict Transport Security. When set, the browser will no longer use insecure http to access the site. Warning: Be sure your site is accessible via https before enabeling this feature. Default: false<\/td>true<\/code><\/td><\/tr>
hsts_maxage<\/td>The time, in seconds which browsers are allowed to remember the HSTS setting of the site. Default: 17280000 (200 days)<\/td><\/td><\/tr>
hsts_include_subdomains<\/td>When set, the browser also does not use http for subdomains. Default: false<\/td><\/td><\/tr>
hsts_preload<\/td>When set, the site's HSTS setting will be stored by the browser vender. This means that browsers only use https. Use with care, because it is hard to revert wrong settings. Default: false<\/td><\/td><\/tr><\/tbody><\/table>\n
Available Model API Paths<\/h2>\n
Method<\/th>Path pattern<\/th>Description<\/th><\/tr><\/thead>
get<\/code><\/td>\/site\/...<\/code><\/td>Return the current site name (atom) from the request context.<\/td><\/tr>
get<\/code><\/td>\/environment\/...<\/code><\/td>Return the resolved DTAP environment (development<\/code>, test<\/code>, acceptance<\/code>, production<\/code>, education<\/code>, or backup<\/code>).<\/td><\/tr>
get<\/code><\/td>\/hostname\/...<\/code><\/td>Return the configured hostname for the current site\/request.<\/td><\/tr>
get<\/code><\/td>\/hostname_port\/...<\/code><\/td>Return hostname including configured HTTP port.<\/td><\/tr>
get<\/code><\/td>\/hostname_ssl_port\/...<\/code><\/td>Return hostname including configured HTTPS port.<\/td><\/tr>
get<\/code><\/td>\/hostalias\/...<\/code><\/td>Return the configured hostalias<\/code> site setting.<\/td><\/tr>
get<\/code><\/td>\/protocol\/...<\/code><\/td>Return the site protocol used for URL construction (typically http<\/code> or https<\/code>).<\/td><\/tr>
get<\/code><\/td>\/is_ssl\/...<\/code><\/td>Return whether the site is currently considered SSL-enabled.<\/td><\/tr>
get<\/code><\/td>\/title\/...<\/code><\/td>Return the configured site title as binary text.<\/td><\/tr>
get<\/code><\/td>\/subtitle\/...<\/code><\/td>Return the configured site subtitle as binary text (empty binary when unset).<\/td><\/tr>
get<\/code><\/td>\/email_from\/...<\/code><\/td>Return the effective sender address used for outgoing email.<\/td><\/tr>
get<\/code><\/td>\/pagelen\/...<\/code><\/td>Return default search page length (configured value or fallback default).<\/td><\/tr>
get<\/code><\/td>\/language\/...<\/code><\/td>Return the current request language.<\/td><\/tr>
get<\/code><\/td>\/default_language\/...<\/code><\/td>Return the site default language.<\/td><\/tr>
get<\/code><\/td>\/security\/...<\/code><\/td>Return generated security.txt<\/code> data (contact<\/code>, optional policy<\/code>\/hiring<\/code>, and expires<\/code>).<\/td><\/tr>
get<\/code><\/td>\/+key\/...<\/code><\/td>Return site config value for +key<\/code> when the key is public or caller is admin; otherwise undefined<\/code>.<\/td><\/tr>
get<\/code><\/td>\/<\/code><\/td>Return all site configuration key\/value pairs for admins, otherwise an empty list. 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":"site","is_protected":false,"visible_for":0,"tz":"UTC","language":["en"],"doc_source_hash":"46408e834d777fa031d1c3f30d13a22035c4c8158469cd214a3f8dd04c61b944","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_site.erl","publication_start":"2023-01-30T19:23:54Z","github_url":"https:\/\/github.com\/zotonic\/zotonic\/blob\/master\/apps\/zotonic_core\/src\/models\/m_site.erl","pivot_location_lng":null,"doc_source_kind":"model","name":"doc_model_model_site","is_unfindable":false,"is_published":true,"pivot_geocode":null,"created":"2020-05-30T05:47:34Z","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":"66cb145eae7002b184e7d8c4c7bba5e53e8248e5\n","erlang_module":"m_site","creator_id":{"id":336,"is_a":["person","robot"],"name":"gitbot","title":"Git","uri":"https:\/\/zotonic.com\/id\/336"},"modified":"2026-10-02T12:40:36Z","title_slug":"site"},"uri":"https:\/\/zotonic.com\/id\/1768","uri_template":"https:\/\/zotonic.com\/id\/:id","websub":{"hub":"https:\/\/zotonic.com\/.zotonic\/websub","topic":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1768"}},"status":"ok"}