{"id":24228,"date":"2026-10-04T10:02:35","date_gmt":"2026-10-04T04:32:35","guid":{"rendered":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/?post_type=article&#038;p=24228"},"modified":"2026-10-07T15:47:48","modified_gmt":"2026-10-07T10:17:48","slug":"how-to-set-up-a-program-project","status":"publish","type":"article","link":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/article\/how-to-set-up-a-program-project\/","title":{"rendered":"How to Set Up a Program Project"},"content":{"rendered":"<style>.post-content .nw{font-size:16px !important;line-height:27px !important;color:#5A5A5A !important}.post-content .nw p{margin:0 0 18px !important;color:#5A5A5A !important;font-size:16px !important;line-height:27px !important}.post-content .nw .lead{font-size:18px !important;line-height:29px !important;color:#6E6E6E !important;margin:0 0 26px !important}.post-content .nw h2{font-size:28px !important;line-height:34px !important;font-weight:700 !important;letter-spacing:-0.5px !important;color:#1A2340 !important;margin:46px 0 16px !important;padding:0 0 0 15px !important;border-left:4px solid #F89A38 !important}.post-content .nw h3{font-size:19px !important;line-height:26px !important;font-weight:600 !important;letter-spacing:-0.2px !important;color:#1A2340 !important;margin:32px 0 10px !important}.post-content .nw strong{font-weight:600 !important;color:#1A2340 !important}.post-content .nw a{color:#1489F6 !important;text-decoration:none !important}.post-content .nw a:hover{text-decoration:underline !important}.post-content .nw ol.st{margin:0 0 22px !important;padding:0 !important;list-style:none !important;counter-reset:s !important}.post-content .nw ol.st li{position:relative !important;counter-increment:s !important;padding:0 0 0 38px !important;margin:0 0 14px !important;color:#5A5A5A !important;font-size:16px !important;line-height:27px !important;font-weight:400 !important;list-style:none !important}.post-content .nw ol.st li::before{content:counter(s) !important;position:absolute !important;left:0 !important;top:1px !important;width:25px !important;height:25px !important;border-radius:50% !important;background:#F89A38 !important;color:#fff !important;font-size:13px !important;font-weight:700 !important;text-align:center !important;line-height:25px !important}.post-content .nw ul.bl{margin:0 0 22px !important;padding:0 !important;list-style:none !important}.post-content .nw ul.bl li{position:relative !important;padding:0 0 0 20px !important;margin:0 0 10px !important;color:#5A5A5A !important;font-size:16px !important;line-height:27px !important;font-weight:400 !important;list-style:none !important}.post-content .nw ul.bl li::before{content:\"\" !important;position:absolute !important;left:2px !important;top:11px !important;width:6px !important;height:6px !important;border-radius:50% !important;background:#F89A38 !important}.post-content .nw .note{background:#F7F8FA !important;border-radius:10px !important;padding:16px 18px 16px 46px !important;margin:24px 0 !important;position:relative !important;font-size:15px !important;line-height:25px !important}.post-content .nw .note::before{content:\"i\" !important;position:absolute !important;left:17px !important;top:17px !important;width:19px !important;height:19px !important;border-radius:50% !important;border:1.5px solid #B4650C !important;color:#B4650C !important;font-size:12px !important;font-weight:700 !important;font-style:italic !important;text-align:center !important;line-height:17px !important}.post-content .nw .note p{margin:0 !important;font-size:15px !important;line-height:25px !important}.post-content .nw .faq{border:1px solid #E4E7EC !important;border-radius:10px !important;overflow:hidden !important;margin:24px 0 !important}.post-content .nw .faq details{background:#fff !important}.post-content .nw .faq details + details{border-top:1px solid #E4E7EC !important}.post-content .nw .faq summary{list-style:none !important;cursor:pointer !important;padding:15px 18px 15px 44px !important;position:relative !important;font-size:16px !important;font-weight:400 !important;color:#5A5A5A !important;line-height:25px !important}.post-content .nw .faq summary::-webkit-details-marker{display:none !important}.post-content .nw .faq summary::before{content:\"\" !important;position:absolute !important;left:19px !important;top:21px !important;width:7px !important;height:7px !important;border-right:2px solid #9AA0AE !important;border-bottom:2px solid #9AA0AE !important;transform:rotate(-45deg) !important;transition:transform .18s ease !important}.post-content .nw .faq details[open] summary{color:#1A2340 !important;font-weight:600 !important}.post-content .nw .faq details[open] summary::before{transform:rotate(45deg) !important}.post-content .nw .faq summary:hover{background:#F7F8FA !important}.post-content .nw .faq .ab{padding:0 18px 16px 44px !important}.post-content .nw .faq .ab p{margin:0 0 12px !important;font-size:15px !important;line-height:25px !important}.post-content .nw .faq .ab p:last-child{margin:0 !important}.post-content .nw .tabs{border:1px solid #E4E7EC !important;border-radius:10px !important;overflow:hidden !important;margin:26px 0 !important}.post-content .nw .tabs input{position:absolute !important;opacity:0 !important;width:0 !important;height:0 !important;pointer-events:none !important}.post-content .nw .tabs > p{margin:0 !important;padding:0 !important;line-height:0 !important}.post-content .nw .tabbar{display:flex !important;flex-wrap:wrap !important;background:#F7F8FA !important;border-bottom:1px solid #E4E7EC !important}.post-content .nw .tabbar label{padding:11px 18px !important;font-size:14px !important;font-weight:500 !important;color:#6E6E6E !important;cursor:pointer !important;border-right:1px solid #E4E7EC !important;margin:0 !important;line-height:20px !important}.post-content .nw .tabbar label:hover{color:#1A2340 !important}.post-content .nw .tp{display:none !important;padding:20px 20px 4px !important}.post-content .nw table{width:100% !important;border-collapse:collapse !important;margin:22px 0 !important;border:1px solid #E4E7EC !important;border-radius:8px !important;overflow:hidden !important}.post-content .nw table th{background:#F7F8FA !important;text-align:left !important;font-size:13px !important;font-weight:700 !important;letter-spacing:.4px !important;text-transform:uppercase !important;color:#1A2340 !important;padding:12px 16px !important;border-bottom:1px solid #E4E7EC !important}.post-content .nw table td{text-align:left !important;font-weight:400 !important;font-size:15px !important;color:#5A5A5A !important;padding:12px 16px !important;border-bottom:1px solid #E4E7EC !important;line-height:24px !important;vertical-align:top !important}.post-content .nw table tr:last-child td{border-bottom:0 !important}.post-content .nw table td,.post-content .nw table th{border-left:0 !important;border-right:0 !important}.post-content .nw figure{margin:26px 0 !important}.post-content .nw figure img{max-width:100% !important;height:auto !important;display:block !important;border:1px solid #E4E7EC !important;border-radius:8px !important}.post-content .nw figcaption{margin:9px 0 0 !important;font-size:13px !important;color:#6E6E6E !important;line-height:20px !important}.post-content .nw .toc{border:1px solid #E4E7EC !important;border-radius:10px !important;padding:20px 24px 10px !important;margin:0 0 34px !important;background:#fff !important}.post-content .nw .toc .tl{margin:0 0 5px !important;font-size:12px !important;letter-spacing:.1em !important;text-transform:uppercase !important;color:#1A2340 !important;font-weight:700 !important}.post-content .nw .toc .tb{width:34px !important;height:3px !important;background:#F89A38 !important;border-radius:2px !important;margin:0 0 8px !important}.post-content .nw .toc ol{margin:0 !important;padding:0 !important;list-style:none !important;counter-reset:t !important}.post-content .nw .toc li{counter-increment:t !important;list-style:none !important;font-weight:400 !important;padding:10px 0 !important;border-bottom:1px solid #E4E7EC !important;font-size:15px !important;line-height:22px !important;margin:0 !important}.post-content .nw .toc li:last-child{border-bottom:0 !important}.post-content .nw .toc li::before{content:counter(t) !important;display:inline-block !important;min-width:21px !important;color:#B4650C !important;font-weight:700 !important;font-size:13px !important}.post-content .nw .toc a{color:#1A2340 !important;text-decoration:none !important}.post-content .nw .toc a:hover{color:#B4650C !important}.post-content .nw .warn{background:#FEF8EE !important;border-radius:10px !important;padding:16px 18px 16px 46px !important;margin:24px 0 !important;position:relative !important;font-size:15px !important;line-height:25px !important}.post-content .nw .warn::before{content:\"!\" !important;position:absolute !important;left:17px !important;top:17px !important;width:19px !important;height:19px !important;border-radius:50% !important;background:#B97E00 !important;color:#fff !important;font-size:12px !important;font-weight:700 !important;text-align:center !important;line-height:19px !important}.post-content .nw .warn p{margin:0 0 10px !important;font-size:15px !important;line-height:25px !important}.post-content .nw .warn p:last-child{margin:0 !important}.post-content .nw .rule{border:1px solid #E4E7EC !important;border-radius:10px !important;padding:20px 22px 8px !important;margin:0 0 16px !important}.post-content .nw .rule h3{margin:0 0 10px !important;font-size:17px !important}.post-content .nw .rule .rn{display:inline-block !important;min-width:26px !important;height:26px !important;line-height:26px !important;border-radius:5px !important;background:#1A2340 !important;color:#fff !important;font-size:12.5px !important;font-weight:700 !important;text-align:center !important;margin-right:11px !important;vertical-align:2px !important;padding:0 6px !important}.post-content .nw .note .nt{margin:0 0 7px !important;font-size:14px !important;font-weight:700 !important;color:#B4650C !important;line-height:20px !important}.post-content .nw .warn .nt{margin:0 0 7px !important;font-size:14px !important;font-weight:700 !important;color:#B97E00 !important;line-height:20px !important}<\/style>\n<div class=\"nw\">\n<div class=\"toc\">\n<p class=\"tl\">Skip Ahead to:<\/p>\n<div class=\"tb\"><\/div>\n<ol>\n<li><a href=\"#Overview\">Overview<\/a><\/li>\n<li><a href=\"#Navigation\">Navigation<\/a><\/li>\n<li><a href=\"#SetUp\">How to Set Up a Program Project?<\/a><\/li>\n<li><a href=\"#Layout\">Layout of the Child Projects Tab<\/a><\/li>\n<li><a href=\"#Rules\">Rules You Should Know<\/a><\/li>\n<\/ol>\n<\/div>\n<h2 id=\"Overview\">Overview<\/h2>\n<p class=\"lead\">When several teams work towards one goal, each team plans well on its own and the whole still drifts. Dependencies surface late, two teams discover they need the same backend service in the same fortnight, and nobody can answer &ldquo;is the quarter on track?&rdquo; without opening every project and adding it up by hand.<\/p>\n<p>So a Program Project solves the grouping problem. You nominate one project as the program, link the team or child projects beneath it, and from that point the program becomes a planning surface in its own right &mdash; one board showing every team&rsquo;s tasks, one place to share releases\/sprints, and one status view across the whole increment.<\/p>\n<p>This is the first thing to set up. Release Planning, Sprint Planning and Release &amp; Sprint Status at the program level all depend on the hierarchy existing, and none of the program-level views appear until a project&rsquo;s category is set to &ldquo;Program&rdquo; in the Project Details page.<\/p>\n<div class=\"note\">\n<p class=\"nt\">Note<\/p>\n<p>Nimble has two different parent-child relationships, and they are independent of each other.<\/p>\n<ul class=\"bl\">\n<li>The <strong>project hierarchy<\/strong> is a Program Project with child projects beneath it. That is what you build in this article.<\/li>\n<li>The <strong>workitem hierarchy<\/strong> is a card with child cards beneath it, such as an epic and its user stories.<\/li>\n<\/ul>\n<p>Therefore, building the project hierarchy does not create any workitem hierarchy.<\/p>\n<\/div>\n<h2 id=\"Navigation\">Navigation<\/h2>\n<p>Navigate to the breadcrumb at the top and select <strong>Plan &rarr; Project Details<\/strong> for the project you want to make a program.<\/p>\n<h2 id=\"SetUp\">How to Set Up a Program Project?<\/h2>\n<p>To set up a Program Project, perform the following steps &ndash;<\/p>\n<ol class=\"st\">\n<li>Create the program project and the child projects as ordinary projects first. To learn more on how to create a project\/program, <a target=\"_blank\" href=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/article\/add-project-overview\/\" rel=\"noopener\">click here<\/a>.<\/li>\n<li>Open the program project and navigate to <strong>Plan &rarr; Project Details<\/strong>.<\/li>\n<li>Set <strong>Project Category<\/strong> to <strong>Program<\/strong>.<\/li>\n<li>Select <strong>Save<\/strong>. The Child Projects tab appears.<\/li>\n<\/ol>\n<h3>Link Child Projects<\/h3>\n<ol class=\"st\" style=\"counter-reset:s 4 !important\">\n<li>Open the <strong>Child Projects<\/strong> tab and select <strong>ADD<\/strong>.<\/li>\n<li>Select the child projects you want to link and click <strong>ADD<\/strong> to confirm.<\/li>\n<li>Verify the hierarchy in the grid that appears.<\/li>\n<\/ol>\n<figure><img decoding=\"async\" src=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-content\/uploads\/2026\/10\/program-project-category-child-projects-tab.png\" alt=\"Project Category set to Program and the Child Projects tab on the Project Details page\" width=\"734\" \/><\/figure>\n<div class=\"warn\">\n<p class=\"nt\">Note<\/p>\n<p>Set the category to Program before adding children. The Child Projects tab does not exist while the category is Project, and the selection list only offers projects that already exist.<\/p>\n<\/div>\n<h2 id=\"Layout\">Layout of the Child Projects Tab<\/h2>\n<p>Note that this tab appears only for projects whose Project Category is Program. Before any children are assigned, it shows an empty state inviting you to group existing projects under the program. Selecting <strong>ADD<\/strong> opens a searchable, multi-select list of eligible projects. Tick the projects you want to attach and confirm.<\/p>\n<h3>Program Hierarchy Grid<\/h3>\n<p>Once children are assigned, the tab lists them with Project Name, Template, Manager, Date Created, Planned Start Date and Planned End Date, along with an action to remove\/de-link a child project. Above all, this grid is the quickest way to catch a setup mistake. A child project on a different template, or one with dates well outside the program window, shows up here before it causes confusion on the planning board.<\/p>\n<figure><img decoding=\"async\" src=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-content\/uploads\/2026\/10\/program-hierarchy-grid.png\" alt=\"Program Hierarchy grid listing the child projects linked to a program project\" width=\"734\" \/><\/figure>\n<p>You can perform common operations such as <a target=\"_blank\" href=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/article\/customize-the-list-views\/\" rel=\"noopener\">rearranging column fields<\/a>, <a target=\"_blank\" href=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/article\/how-to-sort-the-list-view\/#MultiSort\" rel=\"noopener\">sorting<\/a>, and <a target=\"_blank\" href=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/article\/advanced-filter\/#ColumnFilter\" rel=\"noopener\">filtering<\/a>.<\/p>\n<figure><img decoding=\"async\" src=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-content\/uploads\/2026\/10\/program-hierarchy-grid-column-options.png\" alt=\"Column options menu open on the Program Hierarchy grid showing sort, pin and filter\" width=\"734\" \/><\/figure>\n<h2 id=\"Rules\">Rules You Should Know<\/h2>\n<div class=\"rule\">\n<h3><span class=\"rn\">1<\/span>Which Projects Can Become Children<\/h3>\n<p>The selection list only offers eligible projects. It excludes, and does not display at all:<\/p>\n<ul class=\"bl\">\n<li>Projects whose category is Program<\/li>\n<li>Projects already assigned as a child of another program<\/li>\n<li>The current project itself<\/li>\n<\/ul>\n<p>A project can belong to only one program. Once linked, it no longer appears in any other program&rsquo;s selection list.<\/p>\n<div class=\"note\">\n<p class=\"nt\">Note<\/p>\n<p>The hierarchy is single-level. A child project cannot itself be a Program, so programs cannot be nested inside other programs.<\/p>\n<\/div>\n<\/div>\n<div class=\"rule\">\n<h3><span class=\"rn\">2<\/span>Changing the Category After Children Exist<\/h3>\n<ul class=\"bl\">\n<li>A project that is currently a child of a program cannot be promoted to Program. Remove it from its program first.<\/li>\n<li>A Program that has at least one child project cannot revert to Project. Remove all child projects first.<\/li>\n<\/ul>\n<\/div>\n<div class=\"rule\">\n<h3><span class=\"rn\">3<\/span>Removing a Child Project<\/h3>\n<p>Once you remove a child project from a program, it immediately becomes eligible to join another program. Any releases previously shared with it remain in that project as standalone releases.<\/p>\n<\/div>\n<div class=\"rule\">\n<h3><span class=\"rn\">4<\/span>Use the Same Template Across the Program <em>(Recommended)<\/em><\/h3>\n<p>The template fixes which card types a project has. Mixed templates across a program produce teams whose card types do not line up, which makes the program-level board and status views harder to read.<\/p>\n<\/div>\n<\/div>\n<div class=\"helpful-block-content wth-theme-thumbs\" data-title=\"\" >\n<ul>\n<li><span class=\"wth-title\">Was this helpful?<\/span><\/li>\n<li><a data-post=\"24228\" data-post-url=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/article\/how-to-set-up-a-program-project\/\" data-post-title=\"How to Set Up a Program Project\" data-response=\"1\" href=\"#\" class=\"wth-green-btn icon-thumbsup\">Yes<\/a>&nbsp; &nbsp;<a data-response=\"0\" data-post=\"24228\" data-post-url=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/article\/how-to-set-up-a-program-project\/\" data-post-title=\"How to Set Up a Program Project\" href=\"#\" class=\"wth-red-btn icon-thumbsdown\">No<\/a><\/li>\n<\/ul>\n<\/div>","protected":false},"author":4,"featured_media":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","multi-rating":{"mr_rating_results":[]},"_links":{"self":[{"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/article\/24228"}],"collection":[{"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/article"}],"about":[{"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/types\/article"}],"author":[{"embeddable":true,"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/comments?post=24228"}],"version-history":[{"count":20,"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/article\/24228\/revisions"}],"predecessor-version":[{"id":24437,"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/article\/24228\/revisions\/24437"}],"wp:attachment":[{"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/media?parent=24228"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}