{"id":993,"date":"2024-04-09T15:57:13","date_gmt":"2024-04-09T19:57:13","guid":{"rendered":"https:\/\/docs.gravitysmtp.com\/?p=993"},"modified":"2025-11-17T11:39:09","modified_gmt":"2025-11-17T16:39:09","slug":"debug-log","status":"publish","type":"post","link":"https:\/\/docs.gravitysmtp.com\/debug-log\/","title":{"rendered":"Debug Log"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\" id=\"h-introduction\">Introduction<\/h2>\n\n\n\n<p>When enabled <a href=\"https:\/\/docs.gravitysmtp.com\/settings\/#h-debug-logging\">via the Gravity SMTP settings<\/a>, the Debug Log tracks any errors encountered with your integration and\/or the sending of your emails. The Debug Log provides behind-the-scenes details of the sending process, which assists in detecting and diagnosing problems. While it does not provide a comprehensive view of every event and step, the Debug Log captures the information most relevant to our customers for troubleshooting purposes.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-accessing-the-debug-log\">Accessing the Debug Log<\/h2>\n\n\n\n<p>Debug logging is disabled by default. To enable it, visit <strong><em>SMTP \u2192<\/em><\/strong> <strong><em>Settings \u2192<\/em><\/strong> <strong><em>Logging<\/em><\/strong> in your WordPress dashboard and click the toggle. You can set a retention period of one week or one month for the debug logs. Please see <a href=\"https:\/\/docs.gravitysmtp.com\/settings\/#h-debug-logging\">this link<\/a> for more details on those settings.<\/p>\n\n\n\n<p>Once debug logging is turned on, logs will be generated the next time your website sends an email. At that point, you can visit <strong><em>SMTP \u2192 Tools \u2192 Debug Log<\/em><\/strong> to view the logs in a table format as shown below:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"531\" src=\"https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-screen-1024x531.png\" alt=\"screenshot of the debug log screen in Gravity SMTP\" class=\"wp-image-992\" srcset=\"https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-screen-1024x531.png 1024w, https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-screen-300x156.png 300w, https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-screen-768x398.png 768w, https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-screen-1536x797.png 1536w, https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-screen-2048x1062.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-debug-log-actions\">Debug Log Actions<\/h2>\n\n\n\n<p>You can click the eye icon in the Actions column next to any entry in the debug log to view more details about the logged event:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"606\" src=\"https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-actions-1-1024x606.png\" alt=\"screenshot of the debug log actions in Gravity SMTP\" class=\"wp-image-1002\" style=\"width:637px;height:auto\" srcset=\"https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-actions-1-1024x606.png 1024w, https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-actions-1-300x177.png 300w, https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-actions-1-768x454.png 768w, https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-actions-1-1536x908.png 1536w, https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-actions-1.png 1992w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>The details will appear in a modal:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"952\" src=\"https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-modal-1024x952.png\" alt=\"\" class=\"wp-image-1003\" style=\"width:296px;height:auto\" srcset=\"https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-modal-1024x952.png 1024w, https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-modal-300x279.png 300w, https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-modal-768x714.png 768w, https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-modal.png 1216w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-sending-the-debug-log-to-support\">Sending the Debug Log to Support<\/h2>\n\n\n\n<p>When debug logging is enabled, a link to a debug log file is automatically added to your Gravity SMTP System Report. Our support team can view the debug logs when you contact us for assistance if debug logging is enabled, and you include the <a href=\"https:\/\/docs.gravitysmtp.com\/accessing-your-system-report\/\">Gravity SMTP System Report<\/a>. We strongly recommend enabling debug logging and sending a test email before opening a support request, as this will often save time <strong>determining the cause of any sending issues.<\/strong><\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-debug-log-file-security\">Debug Log File Security<\/h3>\n\n\n\n<p>The raw debug log file pulls the relevant information directly from your website&#8217;s database. The maximum timeframe for data retention is one month to minimize any potential performance impact.<\/p>\n\n\n\n<p>The link to the log file is protected by a key added to the end of the URL. The key is generated randomly and refreshed each time debug logging is enabled, and the debug log file cannot be accessed without the key.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>This article explains how to access the Debug Log table in Gravity SMTP, as well as the process to send the information to our support team.<\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_autodraft_ids":null,"_sb_is_suggestion_mode":false,"_sb_show_suggestion_boards":false,"_sb_show_comment_boards":false,"_sb_suggestion_history":"","_sb_update_block_changes":"","_is_real_time_mode":false,"_realtime_collaborators":"","footnotes":"","cf_checklist_status":[]},"categories":[37],"tags":[],"class_list":["post-993","post","type-post","status-publish","format-standard","hentry","category-dashboard-and-logs","wpautop"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v26.6.1 (Yoast SEO v27.3) - https:\/\/yoast.com\/product\/yoast-seo-premium-wordpress\/ -->\n<title>Debug Log - Gravity SMTP Documentation<\/title>\n<meta name=\"description\" content=\"This article explains how to access the Debug Log table in Gravity SMTP, as well as the process to send the information to our support team.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/docs.gravitysmtp.com\/debug-log\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Debug Log\" \/>\n<meta property=\"og:description\" content=\"This article explains how to access the Debug Log table in Gravity SMTP, as well as the process to send the information to our support team.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.gravitysmtp.com\/debug-log\/\" \/>\n<meta property=\"og:site_name\" content=\"Gravity SMTP Documentation\" \/>\n<meta property=\"article:published_time\" content=\"2024-04-09T19:57:13+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-11-17T16:39:09+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-screen.png\" \/>\n\t<meta property=\"og:image:width\" content=\"2530\" \/>\n\t<meta property=\"og:image:height\" content=\"1312\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Andrea Whitmer\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Andrea Whitmer\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/debug-log\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/debug-log\\\/\"},\"author\":{\"name\":\"Andrea Whitmer\",\"@id\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/#\\\/schema\\\/person\\\/05fd41fdba5c21d1b59591b3107a0e50\"},\"headline\":\"Debug Log\",\"datePublished\":\"2024-04-09T19:57:13+00:00\",\"dateModified\":\"2025-11-17T16:39:09+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/debug-log\\\/\"},\"wordCount\":356,\"commentCount\":0,\"image\":{\"@id\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/debug-log\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/wp-content\\\/uploads\\\/2024\\\/04\\\/gravity-smtp-debug-log-screen-1024x531.png\",\"articleSection\":[\"Dashboard And Logs\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/docs.gravitysmtp.com\\\/debug-log\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/debug-log\\\/\",\"url\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/debug-log\\\/\",\"name\":\"Debug Log - Gravity SMTP Documentation\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/debug-log\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/debug-log\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/wp-content\\\/uploads\\\/2024\\\/04\\\/gravity-smtp-debug-log-screen-1024x531.png\",\"datePublished\":\"2024-04-09T19:57:13+00:00\",\"dateModified\":\"2025-11-17T16:39:09+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/#\\\/schema\\\/person\\\/05fd41fdba5c21d1b59591b3107a0e50\"},\"description\":\"This article explains how to access the Debug Log table in Gravity SMTP, as well as the process to send the information to our support team.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/debug-log\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/docs.gravitysmtp.com\\\/debug-log\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/debug-log\\\/#primaryimage\",\"url\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/wp-content\\\/uploads\\\/2024\\\/04\\\/gravity-smtp-debug-log-screen.png\",\"contentUrl\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/wp-content\\\/uploads\\\/2024\\\/04\\\/gravity-smtp-debug-log-screen.png\",\"width\":2530,\"height\":1312},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/debug-log\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Debug Log\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/#website\",\"url\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/\",\"name\":\"Gravity SMTP Documentation\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/#\\\/schema\\\/person\\\/05fd41fdba5c21d1b59591b3107a0e50\",\"name\":\"Andrea Whitmer\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/410837123a42011f1e62168cad3b44f00e6e82e17ca89ec79d78eca400efb38c?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/410837123a42011f1e62168cad3b44f00e6e82e17ca89ec79d78eca400efb38c?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/410837123a42011f1e62168cad3b44f00e6e82e17ca89ec79d78eca400efb38c?s=96&d=mm&r=g\",\"caption\":\"Andrea Whitmer\"},\"url\":\"https:\\\/\\\/docs.gravitysmtp.com\\\/author\\\/andreawhitmer\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Debug Log - Gravity SMTP Documentation","description":"This article explains how to access the Debug Log table in Gravity SMTP, as well as the process to send the information to our support team.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/docs.gravitysmtp.com\/debug-log\/","og_locale":"en_US","og_type":"article","og_title":"Debug Log","og_description":"This article explains how to access the Debug Log table in Gravity SMTP, as well as the process to send the information to our support team.","og_url":"https:\/\/docs.gravitysmtp.com\/debug-log\/","og_site_name":"Gravity SMTP Documentation","article_published_time":"2024-04-09T19:57:13+00:00","article_modified_time":"2025-11-17T16:39:09+00:00","og_image":[{"width":2530,"height":1312,"url":"https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-screen.png","type":"image\/png"}],"author":"Andrea Whitmer","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Andrea Whitmer","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/docs.gravitysmtp.com\/debug-log\/#article","isPartOf":{"@id":"https:\/\/docs.gravitysmtp.com\/debug-log\/"},"author":{"name":"Andrea Whitmer","@id":"https:\/\/docs.gravitysmtp.com\/#\/schema\/person\/05fd41fdba5c21d1b59591b3107a0e50"},"headline":"Debug Log","datePublished":"2024-04-09T19:57:13+00:00","dateModified":"2025-11-17T16:39:09+00:00","mainEntityOfPage":{"@id":"https:\/\/docs.gravitysmtp.com\/debug-log\/"},"wordCount":356,"commentCount":0,"image":{"@id":"https:\/\/docs.gravitysmtp.com\/debug-log\/#primaryimage"},"thumbnailUrl":"https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-screen-1024x531.png","articleSection":["Dashboard And Logs"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/docs.gravitysmtp.com\/debug-log\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/docs.gravitysmtp.com\/debug-log\/","url":"https:\/\/docs.gravitysmtp.com\/debug-log\/","name":"Debug Log - Gravity SMTP Documentation","isPartOf":{"@id":"https:\/\/docs.gravitysmtp.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/docs.gravitysmtp.com\/debug-log\/#primaryimage"},"image":{"@id":"https:\/\/docs.gravitysmtp.com\/debug-log\/#primaryimage"},"thumbnailUrl":"https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-screen-1024x531.png","datePublished":"2024-04-09T19:57:13+00:00","dateModified":"2025-11-17T16:39:09+00:00","author":{"@id":"https:\/\/docs.gravitysmtp.com\/#\/schema\/person\/05fd41fdba5c21d1b59591b3107a0e50"},"description":"This article explains how to access the Debug Log table in Gravity SMTP, as well as the process to send the information to our support team.","breadcrumb":{"@id":"https:\/\/docs.gravitysmtp.com\/debug-log\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.gravitysmtp.com\/debug-log\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/docs.gravitysmtp.com\/debug-log\/#primaryimage","url":"https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-screen.png","contentUrl":"https:\/\/docs.gravitysmtp.com\/wp-content\/uploads\/2024\/04\/gravity-smtp-debug-log-screen.png","width":2530,"height":1312},{"@type":"BreadcrumbList","@id":"https:\/\/docs.gravitysmtp.com\/debug-log\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/docs.gravitysmtp.com\/"},{"@type":"ListItem","position":2,"name":"Debug Log"}]},{"@type":"WebSite","@id":"https:\/\/docs.gravitysmtp.com\/#website","url":"https:\/\/docs.gravitysmtp.com\/","name":"Gravity SMTP Documentation","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/docs.gravitysmtp.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/docs.gravitysmtp.com\/#\/schema\/person\/05fd41fdba5c21d1b59591b3107a0e50","name":"Andrea Whitmer","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/410837123a42011f1e62168cad3b44f00e6e82e17ca89ec79d78eca400efb38c?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/410837123a42011f1e62168cad3b44f00e6e82e17ca89ec79d78eca400efb38c?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/410837123a42011f1e62168cad3b44f00e6e82e17ca89ec79d78eca400efb38c?s=96&d=mm&r=g","caption":"Andrea Whitmer"},"url":"https:\/\/docs.gravitysmtp.com\/author\/andreawhitmer\/"}]}},"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/docs.gravitysmtp.com\/wp-json\/wp\/v2\/posts\/993","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.gravitysmtp.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docs.gravitysmtp.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docs.gravitysmtp.com\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.gravitysmtp.com\/wp-json\/wp\/v2\/comments?post=993"}],"version-history":[{"count":5,"href":"https:\/\/docs.gravitysmtp.com\/wp-json\/wp\/v2\/posts\/993\/revisions"}],"predecessor-version":[{"id":1011,"href":"https:\/\/docs.gravitysmtp.com\/wp-json\/wp\/v2\/posts\/993\/revisions\/1011"}],"wp:attachment":[{"href":"https:\/\/docs.gravitysmtp.com\/wp-json\/wp\/v2\/media?parent=993"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.gravitysmtp.com\/wp-json\/wp\/v2\/categories?post=993"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.gravitysmtp.com\/wp-json\/wp\/v2\/tags?post=993"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}