{"id":1639,"date":"2026-07-05T14:20:03","date_gmt":"2026-07-05T11:20:03","guid":{"rendered":"https:\/\/presta.site\/blog\/docs\/uncategorized\/prestashop-vacation-mode-documentation\/"},"modified":"2026-07-08T11:35:18","modified_gmt":"2026-07-08T08:35:18","password":"","slug":"prestashop-vacation-mode-documentation","status":"publish","type":"docs","link":"https:\/\/presta.site\/blog\/en\/docs\/prestashop-modules\/vacation-mode\/prestashop-vacation-mode-documentation\/","title":{"rendered":"Documentation &#8211; Vacation Mode for PrestaShop"},"content":{"rendered":"<p>This <strong>Documentation Vacation Mode<\/strong> hub covers holiday notices, scheduling, display placements, and customer notifications in PrestaShop.<\/p>\n<p>The Vacation mode module lets PrestaShop merchants display customizable holiday and vacation notices across the storefront. It helps you inform customers about possible shipping delays, office closures, or seasonal breaks while keeping your shop fully open for orders.<\/p>\n<p>The module works with PrestaShop shops from version 1.6.0 through 9.1. It supports multishop environments. See the <a href=\"https:\/\/presta.site\/en\/pro-modules\/33-vacation-mode.html\">Vacation Mode module page<\/a> for product details and pricing.<\/p>\n<p><!--more--><\/p>\n<h2>Documentation Vacation Mode overview<\/h2>\n<h2>Key Features<\/h2>\n<h3>Multi-Location Storefront Messages<\/h3>\n<p>Show vacation notices in up to eight display locations: top banner, popup, home page, left column, product page, cart page, checkout page, and reassurance block. Each placement can have its own message, background color, and layout options.<\/p>\n<h3>Scheduled Vacations with Date Ranges<\/h3>\n<p>Set a start and end date for each vacation profile. The module activates and deactivates notices automatically based on your shop timezone. Leave dates empty to control visibility manually with the <strong>Activate:<\/strong> switch.<\/p>\n<h3>Multiple Vacation Profiles<\/h3>\n<p>Create separate vacation profiles for different events &#8211; for example, summer holidays and Christmas &#8211; using the tabbed interface and the <strong>+<\/strong> button. Multiple profiles can be active at the same time.<\/p>\n<h3>Popup Modal with Dismiss Option<\/h3>\n<p>Display a popup overlay on page load. Customers can click <strong>Don&apos;t show again<\/strong> to hide it for seven days in their browser before it reappears.<\/p>\n<h3>Styling Options<\/h3>\n<p>Customize each notice with background color, optional sticky banner (top or bottom), block margins, and <strong>Constrain block width:<\/strong> to match your theme&apos;s main content area.<\/p>\n<h3>Disable Add to Cart (Per Vacation)<\/h3>\n<p>Each vacation profile has a <strong>Disable Add to cart:<\/strong> switch. When enabled for an active vacation, purchase buttons are <strong>disabled and greyed out<\/strong> on the storefront and new cart additions are blocked. This does <strong>not<\/strong> enable PrestaShop catalog mode and does <strong>not<\/strong> disable checkout &#8211; customers who already have items in the cart can still proceed unless blocked by theme or other modules.<\/p>\n<p>When <strong>Disable Add to cart<\/strong> is <strong>Yes<\/strong>, two additional options appear:<\/p>\n<ul>\n<li><strong>Show explanation near add-to-cart buttons:<\/strong> &#8211; When <strong>Yes<\/strong>, visitors see why ordering is unavailable.<\/li>\n<li><strong>Visitor message:<\/strong> &#8211; Multilingual text shown beside disabled purchase buttons. Leave empty to use the default: <em>Add to cart is temporarily unavailable during our vacation. You can keep browsing &#8211; ordering will reopen soon.<\/em><\/li>\n<\/ul>\n<p>On the <strong>product page<\/strong>, the message appears as a notice below the add-to-cart area. On <strong>category and search listings<\/strong>, a small <strong>!<\/strong> icon appears next to each product; hovering or focusing it shows the full message.<\/p>\n<p>The setting is saved per shop in multishop setups.<\/p>\n<h3>Supplemental Order Email<\/h3>\n<p>Optionally send an additional email when a customer places an order, informing them about possible processing delays during holidays. This is separate from PrestaShop&apos;s standard order confirmation email.<\/p>\n<h3>Back Office Active-Vacation Indicator<\/h3>\n<p>When at least one vacation profile is currently active, an orange <strong>Vacation mode<\/strong> badge appears at the top of the Back Office, linking directly to the module configuration.<\/p>\n<h3>Multishop Per-Shop Activation<\/h3>\n<p>In multishop setups, each vacation profile&apos;s <strong>Activate:<\/strong> setting is saved per shop, so you can run different vacation notices on different stores.<\/p>\n<h2>Navigating the Interface<\/h2>\n<p>The configuration page layout shown in this <strong>Documentation Vacation Mode<\/strong> matches PrestaShop 1.7 and later.<\/p>\n<p>Open the module configuration from <strong>Modules &rarr; Module Manager &rarr; Vacation mode &rarr; Configure<\/strong>.<\/p>\n<p><a href=\"https:\/\/presta.site\/blog\/wp-content\/uploads\/pstv-vacation-docs\/module-conf-page.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/presta.site\/blog\/wp-content\/uploads\/pstv-vacation-docs\/module-conf-page.png\" alt=\"Vacation Mode module configuration page in PrestaShop back office\" width=\"1481\" height=\"840\" class=\"aligncenter size-full wp-image-1632\" srcset=\"https:\/\/presta.site\/blog\/wp-content\/uploads\/pstv-vacation-docs\/module-conf-page.png 1481w, https:\/\/presta.site\/blog\/wp-content\/uploads\/pstv-vacation-docs\/module-conf-page-300x170.png 300w, https:\/\/presta.site\/blog\/wp-content\/uploads\/pstv-vacation-docs\/module-conf-page-1024x581.png 1024w, https:\/\/presta.site\/blog\/wp-content\/uploads\/pstv-vacation-docs\/module-conf-page-768x436.png 768w, https:\/\/presta.site\/blog\/wp-content\/uploads\/pstv-vacation-docs\/module-conf-page-1111x630.png 1111w\" sizes=\"auto, (max-width: 1481px) 100vw, 1481px\" \/><\/a><\/p>\n<h3>Quick Guide<\/h3>\n<p>At the top of the configuration page, a collapsible <strong>Quick guide<\/strong> panel provides step-by-step setup instructions. Click <strong>Hide<\/strong> at the bottom to collapse it; click <strong>(show)<\/strong> in the panel heading to expand it again.<\/p>\n<h3>Vacation Tabs<\/h3>\n<p>Each vacation profile appears as a tab. Tabs without a <strong>Description:<\/strong> are labeled <strong>Vacation #1<\/strong>, <strong>Vacation #2<\/strong>, and so on. Use the <strong>+<\/strong> tab to add a new vacation profile.<\/p>\n<h3>Placement Checkboxes and Save<\/h3>\n<p>Below the <strong>Description:<\/strong>, <strong>Activate:<\/strong>, <strong>Disable Add to cart:<\/strong>, and <strong>Dates:<\/strong> fields, checkboxes list all available display placements and the order email option. When you enable a checkbox, a text editor and styling options appear. Click <strong>Save<\/strong> on that block when finished. On an existing vacation tab, the <strong>Activate:<\/strong> switch, <strong>Dates:<\/strong> field, and <strong>Description:<\/strong> save automatically when changed. On a new <strong>+<\/strong> tab, click <strong>Create<\/strong> first before configuring placements.<\/p>\n<h2>Quick Start: Activating Vacation Mode<\/h2>\n<p>Follow these steps to publish your first notice. The rest of this <strong>Documentation Vacation Mode<\/strong> explains each feature in detail.<\/p>\n<p>To display your first vacation notice:<\/p>\n<ol>\n<li>Open <strong>Modules &rarr; Module Manager &rarr; Vacation mode &rarr; Configure<\/strong> in the PrestaShop back office.<\/li>\n<li>On a vacation tab, check the placements where you want to show information &#8211; for example, <strong>Top banner:<\/strong> and <strong>Home page:<\/strong>.<\/li>\n<li>Enter your message in the text editor for each enabled placement. Adjust <strong>Background color:<\/strong> or other options if needed, then click <strong>Save<\/strong>.<\/li>\n<li>Set <strong>Activate:<\/strong> to <strong>Yes<\/strong>. Optionally set <strong>Dates:<\/strong> for a scheduled vacation period.<\/li>\n<li>If the notice appears lower than expected on the page, go to <strong>Design &rarr; Positions<\/strong>, select <strong>Vacation mode<\/strong>, and drag the module to the top of the relevant hook.<\/li>\n<\/ol>\n<h2>Common Use Cases<\/h2>\n<h3>How to show a vacation banner on the PrestaShop homepage<\/h3>\n<p>On the vacation tab, enable <strong>Home page:<\/strong>, enter your message, and click <strong>Save<\/strong>. Set <strong>Activate:<\/strong> to <strong>Yes<\/strong>. If the banner appears below other content, reorder the module on the <code class=\"codecolorer text default\"><span class=\"text\">displayHome<\/span><\/code> hook via <strong>Design &rarr; Positions<\/strong>.<\/p>\n<h3>How to schedule vacation messages for specific dates<\/h3>\n<p>Set <strong>Activate:<\/strong> to <strong>Yes<\/strong> and choose a date range in <strong>Dates:<\/strong>. The notice becomes visible only while the current date falls within that range. See <a href=\"https:\/\/presta.site\/blog\/en\/docs\/prestashop-modules\/vacation-mode\/managing-vacation-profiles-vacation-mode-for-prestashop\/#scheduling-vacations-by-date\">Scheduling vacations by date<\/a> for timezone and end-of-day behavior.<\/p>\n<h3>How to display different messages on checkout vs product pages<\/h3>\n<p>Enable <strong>Product page:<\/strong> and <strong>Checkout page:<\/strong> (or <strong>Cart page:<\/strong>) on the same or different vacation tabs. Enter a different message for each placement and click <strong>Save<\/strong> on each block. Both can be active simultaneously.<\/p>\n<p><strong>Cart page:<\/strong> shows on the shopping cart page (<code class=\"codecolorer text default\"><span class=\"text\">displayShoppingCart<\/span><\/code>). <strong>Checkout page:<\/strong> shows at the top of the order summary during checkout (<code class=\"codecolorer text default\"><span class=\"text\">displayCheckoutSummaryTop<\/span><\/code>; use <strong>Custom checkout hook<\/strong> only on themes that need <code class=\"codecolorer text default\"><span class=\"text\">displayCheckout<\/span><\/code>).<\/p>\n<h3>How to notify customers about holiday shipping delays without closing the store<\/h3>\n<p>Enable storefront placements such as <strong>Top banner:<\/strong> or <strong>Checkout page:<\/strong> with your delay message. Optionally enable <strong>Send email to the customer on order creation:<\/strong> to send a supplemental notice when orders are placed. Optionally enable <strong>Disable Add to cart:<\/strong> to disable purchase buttons during the vacation without closing the store, and turn on <strong>Show explanation near add-to-cart buttons:<\/strong> so customers understand why.<\/p>\n<h3>How to create separate summer and Christmas vacation notices<\/h3>\n<p>Click the <strong>+<\/strong> tab to add a second vacation profile. Give each tab a <strong>Description:<\/strong> (for example, &quot;Summer 2026&quot; and &quot;Christmas 2026&quot;). Configure placements and messages separately. Schedule each with <strong>Dates:<\/strong> or toggle <strong>Activate:<\/strong> manually.<\/p>\n<h3>How to fix a vacation message appearing at the bottom of the page<\/h3>\n<p>PrestaShop places newly installed modules at the bottom of hook output by default. Go to <strong>Design &rarr; Positions<\/strong>, select <strong>Vacation mode<\/strong> in the module filter, find the hook (for example, <code class=\"codecolorer text default\"><span class=\"text\">displayHome<\/span><\/code>), and drag the module row to the top. See the <a href=\"https:\/\/presta.site\/blog\/en\/docs\/prestashop-modules\/vacation-mode\/display-locations-reference-vacation-mode-for-prestashop\/\">Display Locations Reference<\/a> for details.<\/p>\n<h2>Documentation Map<\/h2>\n<p>The <strong>Documentation Vacation Mode<\/strong> map below lists every Vacation Mode guide.<\/p>\n<p>For detailed information on specific features, refer to the following guides:<\/p>\n<ul>\n<li>Review all display placements, styling options, and hook positions in the <a href=\"https:\/\/presta.site\/blog\/en\/docs\/prestashop-modules\/vacation-mode\/display-locations-reference-vacation-mode-for-prestashop\/\">Display Locations Reference<\/a>.<\/li>\n<li>Learn how to manage vacation profiles, schedule by date, and configure order emails in the <a href=\"https:\/\/presta.site\/blog\/en\/docs\/prestashop-modules\/vacation-mode\/managing-vacation-profiles-vacation-mode-for-prestashop\/\">Managing Vacation Profiles guide<\/a>.<\/li>\n<li>For scheduling details, see <a href=\"https:\/\/presta.site\/blog\/en\/docs\/prestashop-modules\/vacation-mode\/managing-vacation-profiles-vacation-mode-for-prestashop\/#scheduling-vacations-by-date\">Scheduling vacations by date<\/a>.<\/li>\n<li>For order email setup, see <a href=\"https:\/\/presta.site\/blog\/en\/docs\/prestashop-modules\/vacation-mode\/managing-vacation-profiles-vacation-mode-for-prestashop\/#order-email-notifications\">Order email notifications<\/a>.<\/li>\n<\/ul>\n<h2>Compatibility Notes<\/h2>\n<p>These <strong>Documentation Vacation Mode<\/strong> compatibility notes apply across PrestaShop versions and themes.<\/p>\n<ul>\n<li><strong>PrestaShop versions<\/strong>: Compatible with PrestaShop 1.6.0 through 9.1.<\/li>\n<li><strong>Multishop<\/strong>: <strong>Activate:<\/strong> is stored per shop. Configure vacations in the appropriate shop context.<\/li>\n<li><strong>Themes<\/strong>: Display placement availability depends on your theme. Some hooks may not exist; use <strong>Use alternative position:<\/strong> where available. <strong>Reassurance info:<\/strong> placement varies by theme &#8211; in many default themes it appears on the product page, shopping cart, and checkout. See the <a href=\"https:\/\/devdocs.prestashop-project.org\/9\/modules\/concepts\/hooks\/\" target=\"_blank\" rel=\"noopener\">PrestaShop hooks documentation<\/a> for how hooks work in themes.<\/li>\n<li><strong>Languages<\/strong>: Vacation message content supports all languages configured in your shop.<\/li>\n<\/ul>\n<h2>Data Scope<\/h2>\n<p>This <strong>Documentation Vacation Mode<\/strong> summarizes what Vacation Mode changes on your storefront and in the Back Office.<\/p>\n<p>The Vacation mode module displays information and sends optional supplemental emails. It:<\/p>\n<ul>\n<li>Shows customizable HTML messages on the storefront<\/li>\n<li>Sends an additional email on order creation when that placement is enabled<\/li>\n<li>Displays an active-vacation reminder in the Back Office<\/li>\n<li>Disables add-to-cart buttons and blocks new cart additions when <strong>Disable Add to cart<\/strong> is enabled (optionally with a visitor explanation)<\/li>\n<\/ul>\n<p>It does <strong>not<\/strong>:<\/p>\n<ul>\n<li>Enable PrestaShop catalog mode (unless you enable that separately in shop settings)<\/li>\n<li>Hide products or categories from the catalog<\/li>\n<li>Automatically modify shipping dates, order statuses, or delivery estimates<\/li>\n<li>Replace PrestaShop&apos;s standard order confirmation email<\/li>\n<\/ul>\n<p><strong>Disable Add to cart<\/strong> greys out purchase buttons and blocks new additions during an active vacation but does not prevent checkout for existing cart contents.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>This Documentation Vacation Mode hub covers holiday notices, scheduling, display placements, and customer notifications in PrestaShop. The Vacation mode module lets PrestaShop merchants display customizable holiday and vacation notices across the storefront. It helps you inform customers about possible shipping delays, office closures, or seasonal breaks while keeping your shop fully open for orders. The &hellip; <a href=\"https:\/\/presta.site\/blog\/en\/docs\/prestashop-modules\/vacation-mode\/prestashop-vacation-mode-documentation\/\" class=\"more-link\">Continue reading <span class=\"screen-reader-text\">Documentation &#8211; Vacation Mode for PrestaShop<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[245],"doc_tag":[],"class_list":["post-1639","docs","type-docs","status-publish","hentry","doc_category-vacation-mode"],"year_month":"2026-07","word_count":1472,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"Alex C.","author_nicename":"polosat","author_url":"https:\/\/presta.site\/blog\/author\/polosat\/"},"doc_category_info":[{"term_name":"Vacation Mode","term_url":"https:\/\/presta.site\/blog\/en\/docs\/prestashop-modules\/vacation-mode\/"}],"doc_tag_info":[],"_links":{"self":[{"href":"https:\/\/presta.site\/blog\/wp-json\/wp\/v2\/docs\/1639","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/presta.site\/blog\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/presta.site\/blog\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/presta.site\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/presta.site\/blog\/wp-json\/wp\/v2\/comments?post=1639"}],"version-history":[{"count":10,"href":"https:\/\/presta.site\/blog\/wp-json\/wp\/v2\/docs\/1639\/revisions"}],"predecessor-version":[{"id":1720,"href":"https:\/\/presta.site\/blog\/wp-json\/wp\/v2\/docs\/1639\/revisions\/1720"}],"wp:attachment":[{"href":"https:\/\/presta.site\/blog\/wp-json\/wp\/v2\/media?parent=1639"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/presta.site\/blog\/wp-json\/wp\/v2\/doc_category?post=1639"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/presta.site\/blog\/wp-json\/wp\/v2\/doc_tag?post=1639"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}