{"id":10466,"date":"2025-09-22T20:09:44","date_gmt":"2025-09-23T00:09:44","guid":{"rendered":"https:\/\/learndash.com\/support\/?post_type=docs&#038;p=10466"},"modified":"2025-09-23T10:31:33","modified_gmt":"2025-09-23T14:31:33","password":"","slug":"how-to-configure-the-directory-block","status":"publish","type":"docs","link":"https:\/\/learndash.com\/support\/kb\/learndash-app\/managing-content-for-learndash-app\/how-to-configure-the-directory-block\/","title":{"rendered":"How to Configure the Directory Block"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\" id=\"h-introduction\"><strong>Introduction<\/strong><\/h2>\n\n\n\n<p>The LearnDash App Directory Block allows you to map different post types to create custom archive-style listings within your app. This block provides a flexible, single-block layout designed to enhance user engagement and maintain design consistency.<\/p>\n\n\n\n<p><strong>Note:<\/strong> The Directory Block must be the only block on a screen. It cannot be used alongside other blocks.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-add-the-directory-block\"><strong>Add the Directory Block<\/strong><\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to your<strong> Learndash App > App Pages<\/strong><strong><br><\/strong><\/li>\n\n\n\n<li><strong>Edit <\/strong>or <strong>Add a New App Page<\/strong><strong><br><\/strong><\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/lh7-rt.googleusercontent.com\/docsz\/AD_4nXcB5sPnaQbCTEFkHNHk2acPIJY9A45i47SZbOL3kgcLfwJ33z0vbLxuTK5OMq5PbMFj7VHRs6GHsgIJ_ijKfrk1A0_MRUWYTnOQB4osom34ic3r3olx8g5L8_4sldwIOEAtn2dV5w?key=mZiWN04wf_fSfyqrkakBfw\" alt=\"\"\/><\/figure>\n\n\n\n<ol start=\"3\" class=\"wp-block-list\">\n<li>Open your App Page editor.<br><\/li>\n\n\n\n<li>Click the <strong>Toggle Block Inserter<\/strong>.<\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/lh7-rt.googleusercontent.com\/docsz\/AD_4nXfx2fncNolEDHs2st3VgCLp4nthfw7FBxIk09NOydvgHbjqJj6AkJ2Ne5NOviHmTy6dMC_o_5vt15jIrWw80-dVbqSu_WEuGV1jtVkgvDv-fUBG2RAXO4WPmwZI_rkwF_L4tt5a?key=mZiWN04wf_fSfyqrkakBfw\" alt=\"\"\/><\/figure>\n\n\n\n<ol start=\"5\" class=\"wp-block-list\">\n<li>Search for <strong>Directory<\/strong>, then <strong>drag the Directory Block<\/strong> onto the canvas.<br><\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/lh7-rt.googleusercontent.com\/docsz\/AD_4nXcgh5yq4XfMrJVs6GKKloaq9uY7uzyucckkQqf-4anXYTqw8kSz20giUsySNDdtrOv1-zGHhrVbUEpoL6qBSI8pU3MLo-4YuFlnVNN9Ctw6i7kkheeYYd6bjc6D0OWZUQ48XIhSpg?key=mZiWN04wf_fSfyqrkakBfw\" alt=\"\"\/><\/figure>\n\n\n\n<p><strong>Hover Preview:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>When inserted, the block shows a skeleton preview layout.<br><\/li>\n\n\n\n<li>Placeholders labeled <strong>META 1, META 2, META 3, and META 4<\/strong> indicate custom metadata positions.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-configure-block-settings\"><strong>Configure Block Settings<\/strong><\/h2>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/lh7-rt.googleusercontent.com\/docsz\/AD_4nXcnu1ZOzV_XEVM1Zv3APzRLw6a_wnojoZDbJiB1nRgeUlI9T0-XXVWYK_YOyOvCI_r3rY4-ZQDA4F_E0xpUK5hKl8jddHGYwXSP8pgD6JTkNVNv8ogqBlxDHPeq0pHNWidJeVVA?key=mZiWN04wf_fSfyqrkakBfw\" alt=\"\"\/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-select-post-type\"><strong>Select Post Type<\/strong><\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Open the <strong>Block Settings Sidebar<\/strong>.<br><\/li>\n\n\n\n<li>Under <strong>Select Post Type<\/strong>, choose the post type you want to display:<br><\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/lh7-rt.googleusercontent.com\/docsz\/AD_4nXdqn5gyHT__L769IaRVO_E66zkYccTaTYTT6l-Fa0yUPNGbL8pcqGEcPN6WjDa13OTR_TcrKrKhjSWb0YHX4V_EB0XecqmEbzvTQLPMZHaaWcKp4nO70aG2M1hti11AzATqTek_?key=mZiWN04wf_fSfyqrkakBfw\" alt=\"\"\/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-show-featured-images\"><strong>Show Featured Images<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Enable <strong>Show Featured Image<\/strong> to display thumbnails for applicable content.<br><\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/lh7-rt.googleusercontent.com\/docsz\/AD_4nXdKLSq_G-vkzjFHyCnUqrI4bKlMkiBTcwR4VGZj7MYQ7avd4Kg77caMBq458cuirqWcsTpY1sNWfISbK050w93r-SiBYwpVWMi_-4yC4y2R3ep6u0lkErmTQYVOWcDOuqal-8PqVA?key=mZiWN04wf_fSfyqrkakBfw\" alt=\"\"\/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-meta-data-display\"><strong>Meta Data Display<\/strong><\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Scroll to the <strong>Metadata<\/strong> section.<br><\/li>\n\n\n\n<li>Enable <strong>Meta 1<\/strong> and select the field to display.<br><\/li>\n\n\n\n<li>Click <strong>Add Meta<\/strong> to include up to four metadata fields total.<\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/lh7-rt.googleusercontent.com\/docsz\/AD_4nXdiGqGJrU9zmnkmHDRIxgB5o7PH2_JbqC7D4N15DnalrTb8MSIA0p-ZSrN9n4dUbQ2qCvc5lXwkwSY1ywmDRS5TA6r6tLYOFgSrgq0o4JB1NSr6K5WAlnfpoQaJ5rJp9Iqu4ThJ-A?key=mZiWN04wf_fSfyqrkakBfw\" alt=\"\"\/><\/figure>\n\n\n\n<p><em>Note: A maximum of 4 metadata fields can be displayed.<\/em><\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-directory-options\"><strong>Directory Options<\/strong><\/h3>\n\n\n\n<p>Toggle the following features to customize the display:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Show Search Bar<\/strong> \u2013 Adds a search input field.<br><\/li>\n\n\n\n<li><strong>Show Avatar<\/strong> \u2013 Displays the author&#8217;s avatar.<br><\/li>\n\n\n\n<li><strong>Show Search Filter<\/strong> \u2013 Adds filter functionality to the search bar.<br><\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/lh7-rt.googleusercontent.com\/docsz\/AD_4nXdyFOr0RvAqB6qEmiMiNNbyo83uOxm-7J61yik--O24jGv30DZYoTLEddL-9fq2YGzTmDRafxNclR7o-cXitMnR4O4Vg2EYrnZfbgj3hmWMMzXLLbsd_e2T-0AaDRTIaRqYtwiznQ?key=mZiWN04wf_fSfyqrkakBfw\" alt=\"\"\/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-set-order-options\"><strong>Set Order Options<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Choose your preferred sorting from the <strong>Order By<\/strong> and <strong>Order<\/strong> dropdowns (e.g., date, title, ascending\/descending).<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/lh7-rt.googleusercontent.com\/docsz\/AD_4nXc9LSu_HNggtzkT5DNZ_o-CdMd8bzPa5NvMRMyvL3zDbu8UXboiqxiR_N30N2pKFf8BOB5FnyeslfNCI3FOxezdkGpfzAhi3aMmXKnyt47xA0t5BHMFXrdkNP-fwZm8MliaN1Nl4g?key=mZiWN04wf_fSfyqrkakBfw\" alt=\"\"\/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-important-notes\"><strong>Important Notes<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>If you add the Directory Block to a page <strong>with other blocks<\/strong>, you will see this error:<br><strong>\u201cDirectory block cannot be placed on a screen with additional blocks.\u201d<\/strong><strong><br><\/strong><\/li>\n\n\n\n<li>Adding <strong>any additional block<\/strong> to a screen already containing the Directory Block will trigger the same error.<br><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-troubleshooting-and-faqs\"><strong>Troubleshooting and FAQs<\/strong><\/h2>\n\n\n\n<p><strong>Q: What happens if I add the Directory Block to a page with other blocks?<\/strong><strong><br><\/strong> A: You\u2019ll receive an error: <em>\u201cDirectory block cannot be placed on a screen with additional blocks.\u201d<\/em><\/p>\n\n\n\n<p><strong>Q: Featured images aren\u2019t appearing, what should I check?<\/strong><strong><br><\/strong> A: Confirm that <strong>Show Featured Image<\/strong> is enabled in the block settings.<\/p>\n\n\n\n<p><strong>Q: How can I add or change metadata fields?<\/strong><strong><br><\/strong> A: Enable <strong>Meta 1<\/strong>, then use <strong>Add Meta<\/strong> to include up to 4 fields.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Introduction The LearnDash App Directory Block allows you to map different post types to create custom archive-style listings within your app. This block provides a flexible, single-block layout designed to enhance user engagement and maintain design consistency. Note: The Directory Block must be the only block on a screen. It cannot be used alongside other&#8230;<\/p>\n","protected":false},"author":58,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_helpful_status":1,"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_swpsp_post_exclude":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"doc_category":[288],"doc_tag":[],"knowledge_base":[283],"class_list":["post-10466","docs","type-docs","status-publish","hentry","doc_category-managing-content-for-learndash-app","knowledge_base-learndash-app"],"year_month":"2026-04","word_count":368,"total_views":"382","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"display_name":"Stephanie Liy","author_link":"https:\/\/learndash.com\/support\/author\/stephaniei\/"},"doc_category_info":[{"term_name":"Managing Content for LearnDash App","term_url":"https:\/\/learndash.com\/support\/kb\/learndash-app\/managing-content-for-learndash-app\/"}],"doc_tag_info":[],"taxonomy_info":{"doc_category":[{"value":288,"label":"Managing Content for LearnDash App"}],"knowledge_base":[{"value":283,"label":"LearnDash App"}]},"featured_image_src_large":false,"comment_info":0,"knowledge_base_info":[{"term_name":"LearnDash App","term_url":"https:\/\/learndash.com\/support\/kb\/learndash-app\/","term_slug":"learndash-app"}],"knowledge_base_slug":["learndash-app"],"_links":{"self":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs\/10466","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/users\/58"}],"replies":[{"embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/comments?post=10466"}],"version-history":[{"count":1,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs\/10466\/revisions"}],"predecessor-version":[{"id":10467,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs\/10466\/revisions\/10467"}],"wp:attachment":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/media?parent=10466"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/doc_category?post=10466"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/doc_tag?post=10466"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/knowledge_base?post=10466"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}