{"id":35094,"date":"2025-06-04T06:25:46","date_gmt":"2025-06-04T06:25:46","guid":{"rendered":"https:\/\/docs.daftra.com\/?post_type=user_manual&#038;p=35094"},"modified":"2025-06-04T06:25:46","modified_gmt":"2025-06-04T06:25:46","slug":"residency-expiry-alert-widget","status":"publish","type":"user_manual","link":"https:\/\/docs.daftra.com\/en\/user_manual\/residency-expiry-alert-widget\/","title":{"rendered":"Residency Expiry Alert Widget"},"content":{"rendered":"<section class=\"wpb-content-wrapper\"><p>[vc_row][vc_column][vc_column_text]If you have employees who are not citizens and their residency is about to expire, it&#8217;s essential to stay informed in advance to take necessary actions, such as renewals or documentation updates. This tutorial will guide you through displaying a widget that shows upcoming residency permit expirations.[\/vc_column_text][vc_separator][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text]Let&#8217;s assume that you have a new employee in your company who is not a citizen, and you need to keep their residency expiration details in order to ensure timely renewals and avoid any legal or compliance issues.<\/p>\n<p>By entering this information in the system, the employee\u2019s residency expiry date will be automatically tracked and shown in the widget that displays the next 10 upcoming residency expirations.<\/p>\n<p>Click on &#8220;<strong>Manage Employees<\/strong>&#8220;, from the dropdown of &#8220;<strong>Employees<\/strong>&#8220;, click on the &#8220;<strong>Add New<\/strong>&#8221; button.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-35098\" src=\"https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/apu3gijtf.png\" alt=\"\" width=\"1366\" height=\"603\" srcset=\"https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/apu3gijtf.png 1366w, https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/apu3gijtf-300x132.png 300w, https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/apu3gijtf-1024x452.png 1024w, https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/apu3gijtf-768x339.png 768w\" sizes=\"auto, (max-width: 1366px) 100vw, 1366px\" \/><\/p>\n<p>Fill in the the required data, then scroll down to the &#8220;<strong>Personal Information<\/strong>&#8221; section where you&#8217;ll find the following:<\/p>\n<ul>\n<li data-start=\"55\" data-end=\"166\"><strong>Country:<\/strong> Select the country in which the employee holds residency to accurately reflect their legal status.<\/li>\n<li data-start=\"170\" data-end=\"304\"><strong>Citizenship Status:<\/strong> Choose whether the employee is a citizen or resident.<\/li>\n<li data-start=\"170\" data-end=\"304\"><strong>Nationality:<\/strong> Specify the employee&#8217;s nationality for official documentation and reporting purposes.<\/li>\n<li data-start=\"308\" data-end=\"410\"><strong>Expiry Date of Residence:<\/strong> Enter the date on which the employee&#8217;s current residency permit will expire to enable timely alerts and renewal tracking.<\/li>\n<\/ul>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-35109 size-full\" src=\"https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/jtryfgtjh.png\" alt=\"\" width=\"1024\" height=\"537\" srcset=\"https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/jtryfgtjh.png 1024w, https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/jtryfgtjh-300x157.png 300w, https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/jtryfgtjh-768x403.png 768w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<article class=\"text-token-text-primary w-full\" dir=\"auto\" data-testid=\"conversation-turn-164\" data-scroll-anchor=\"true\">\n<div class=\"text-base my-auto mx-auto py-5 [--thread-content-margin:--spacing(4)] @[37rem]:[--thread-content-margin:--spacing(6)] @[72rem]:[--thread-content-margin:--spacing(16)] px-(--thread-content-margin)\">\n<div class=\"[--thread-content-max-width:32rem] @[34rem]:[--thread-content-max-width:40rem] @[64rem]:[--thread-content-max-width:48rem] mx-auto flex max-w-(--thread-content-max-width) flex-1 text-base gap-4 md:gap-5 lg:gap-6 group\/turn-messages focus-visible:outline-hidden\" tabindex=\"-1\">\n<div class=\"group\/conversation-turn relative flex w-full min-w-0 flex-col agent-turn\">\n<div class=\"relative flex-col gap-1 md:gap-3\">\n<div class=\"flex max-w-full flex-col grow\">\n<div class=\"min-h-8 text-message relative flex w-full flex-col items-end gap-2 text-start break-words whitespace-normal [.text-message+&amp;]:mt-5\" dir=\"auto\" data-message-author-role=\"assistant\" data-message-id=\"29e57ddc-afaa-4529-9031-7c241fc77dbe\" data-message-model-slug=\"gpt-4o\">\n<div class=\"flex w-full flex-col gap-1 empty:hidden first:pt-[3px]\">\n<div class=\"markdown prose dark:prose-invert w-full break-words dark\">\n<p data-start=\"52\" data-end=\"187\" data-is-last-node=\"\" data-is-only-node=\"\">In this example, the employee\u2019s residency permit is approaching its expiration date. When navigating to the &#8220;<strong>Human Resources<\/strong>&#8221; dashboard, an alert will appear to notify you that an employee\u2019s residency is about to expire.<\/p>\n<p data-start=\"52\" data-end=\"187\" data-is-last-node=\"\" data-is-only-node=\"\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-35102\" src=\"https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/9upgatoirf.png\" alt=\"\" width=\"1366\" height=\"633\" srcset=\"https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/9upgatoirf.png 1366w, https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/9upgatoirf-300x139.png 300w, https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/9upgatoirf-1024x475.png 1024w, https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/9upgatoirf-768x356.png 768w\" sizes=\"auto, (max-width: 1366px) 100vw, 1366px\" \/><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/article>\n<p>[\/vc_column_text][\/vc_column][\/vc_row]<\/p>\n<\/section>","protected":false},"author":23,"template":"","categories":[2201],"tags":[],"class_list":["post-35094","user_manual","type-user_manual","status-publish","hentry","category-employees"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v17.8 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Residency Expiry Alert Widget - Daftra Knowledge Base<\/title>\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.daftra.com\/en\/user_manual\/residency-expiry-alert-widget\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Residency Expiry Alert Widget - Daftra Knowledge Base\" \/>\n<meta property=\"og:description\" content=\"[vc_row][vc_column][vc_column_text]If you have employees who are not citizens and their residency is about to expire, it&#8217;s essential to stay informed in advance to take necessary actions, such as renewals or documentation updates. This tutorial will guide you through displaying a widget that shows upcoming residency permit expirations.[\/vc_column_text][vc_separator][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text]Let&#8217;s assume that you have a new employee in [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.daftra.com\/en\/user_manual\/residency-expiry-alert-widget\/\" \/>\n<meta property=\"og:site_name\" content=\"Daftra Knowledge Base\" \/>\n<meta property=\"og:image\" content=\"https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/apu3gijtf.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebSite\",\"@id\":\"https:\/\/docs.daftra.com\/#website\",\"url\":\"https:\/\/docs.daftra.com\/\",\"name\":\"Daftra Knowledge Base\",\"description\":\"Daftra\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/docs.daftra.com\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/docs.daftra.com\/en\/user_manual\/residency-expiry-alert-widget\/#primaryimage\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/apu3gijtf.png\",\"contentUrl\":\"https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/apu3gijtf.png\",\"width\":1366,\"height\":603},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/docs.daftra.com\/en\/user_manual\/residency-expiry-alert-widget\/#webpage\",\"url\":\"https:\/\/docs.daftra.com\/en\/user_manual\/residency-expiry-alert-widget\/\",\"name\":\"Residency Expiry Alert Widget - Daftra Knowledge Base\",\"isPartOf\":{\"@id\":\"https:\/\/docs.daftra.com\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/docs.daftra.com\/en\/user_manual\/residency-expiry-alert-widget\/#primaryimage\"},\"datePublished\":\"2025-06-04T06:25:46+00:00\",\"dateModified\":\"2025-06-04T06:25:46+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.daftra.com\/en\/user_manual\/residency-expiry-alert-widget\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/docs.daftra.com\/en\/user_manual\/residency-expiry-alert-widget\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.daftra.com\/en\/user_manual\/residency-expiry-alert-widget\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/docs.daftra.com\/en\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Residency Expiry Alert Widget\"}]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Residency Expiry Alert Widget - Daftra Knowledge Base","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.daftra.com\/en\/user_manual\/residency-expiry-alert-widget\/","og_locale":"en_US","og_type":"article","og_title":"Residency Expiry Alert Widget - Daftra Knowledge Base","og_description":"[vc_row][vc_column][vc_column_text]If you have employees who are not citizens and their residency is about to expire, it&#8217;s essential to stay informed in advance to take necessary actions, such as renewals or documentation updates. This tutorial will guide you through displaying a widget that shows upcoming residency permit expirations.[\/vc_column_text][vc_separator][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text]Let&#8217;s assume that you have a new employee in [&hellip;]","og_url":"https:\/\/docs.daftra.com\/en\/user_manual\/residency-expiry-alert-widget\/","og_site_name":"Daftra Knowledge Base","og_image":[{"url":"https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/apu3gijtf.png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebSite","@id":"https:\/\/docs.daftra.com\/#website","url":"https:\/\/docs.daftra.com\/","name":"Daftra Knowledge Base","description":"Daftra","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/docs.daftra.com\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"ImageObject","@id":"https:\/\/docs.daftra.com\/en\/user_manual\/residency-expiry-alert-widget\/#primaryimage","inLanguage":"en-US","url":"https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/apu3gijtf.png","contentUrl":"https:\/\/docs.daftra.com\/wp-content\/uploads\/2025\/06\/apu3gijtf.png","width":1366,"height":603},{"@type":"WebPage","@id":"https:\/\/docs.daftra.com\/en\/user_manual\/residency-expiry-alert-widget\/#webpage","url":"https:\/\/docs.daftra.com\/en\/user_manual\/residency-expiry-alert-widget\/","name":"Residency Expiry Alert Widget - Daftra Knowledge Base","isPartOf":{"@id":"https:\/\/docs.daftra.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/docs.daftra.com\/en\/user_manual\/residency-expiry-alert-widget\/#primaryimage"},"datePublished":"2025-06-04T06:25:46+00:00","dateModified":"2025-06-04T06:25:46+00:00","breadcrumb":{"@id":"https:\/\/docs.daftra.com\/en\/user_manual\/residency-expiry-alert-widget\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.daftra.com\/en\/user_manual\/residency-expiry-alert-widget\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.daftra.com\/en\/user_manual\/residency-expiry-alert-widget\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/docs.daftra.com\/en\/"},{"@type":"ListItem","position":2,"name":"Residency Expiry Alert Widget"}]}]}},"_links":{"self":[{"href":"https:\/\/docs.daftra.com\/en\/wp-json\/wp\/v2\/user_manual\/35094","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.daftra.com\/en\/wp-json\/wp\/v2\/user_manual"}],"about":[{"href":"https:\/\/docs.daftra.com\/en\/wp-json\/wp\/v2\/types\/user_manual"}],"author":[{"embeddable":true,"href":"https:\/\/docs.daftra.com\/en\/wp-json\/wp\/v2\/users\/23"}],"version-history":[{"count":6,"href":"https:\/\/docs.daftra.com\/en\/wp-json\/wp\/v2\/user_manual\/35094\/revisions"}],"predecessor-version":[{"id":35111,"href":"https:\/\/docs.daftra.com\/en\/wp-json\/wp\/v2\/user_manual\/35094\/revisions\/35111"}],"wp:attachment":[{"href":"https:\/\/docs.daftra.com\/en\/wp-json\/wp\/v2\/media?parent=35094"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.daftra.com\/en\/wp-json\/wp\/v2\/categories?post=35094"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.daftra.com\/en\/wp-json\/wp\/v2\/tags?post=35094"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}