# Upgrading to Kirby 3: Creating a Panel - Help needed

**URL:** <https://forum.getkirby.com/t/upgrading-to-kirby-3-creating-a-panel-help-needed/28295>\
**Category:** Questions\
**Tags:** v3\
**Created:** [April 4, 2023, 8:19am UTC](https://forum.getkirby.com/t/upgrading-to-kirby-3-creating-a-panel-help-needed/28295 "2023-04-04T08:19:15Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![stml](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.getkirby.com/stml/32/4028_2.png) [@stml](https://forum.getkirby.com/u/stml)\
**Post date:** [April 4, 2023, 8:19am UTC](https://forum.getkirby.com/t/upgrading-to-kirby-3-creating-a-panel-help-needed/28295/1 "2023-04-04T08:19:15Z")

</div>

I am at a bit of a loss trying to upgrade my site from 2 to 3. The site works, but I simply do not understand the new Panel system.

I had a simple portfolio site under Kirby 2. There are pages, and there are ‘works’ which were subpages of the ‘work’ page, defined by their own yml files. That was it.

I cannot for the life of me figure out how to recreate the (extremely simple!) panel layout I had under Kirby 2. I know I need to make a new site.yml but the terminology now used doesn’t seem to have any relation to the previous version. I can’t get all of the pages to appear in a pages section, and I can’t figure out how to even display the ‘work’ pages in the panel. I’m stuck at Square One.

I’ve read a lot of posts here and tried to understand the documentation. I’ve used Kirby 2 for ages, and plenty of other systems, but is there a tutorial somewhere that might help? Anything than just pointing to lots of new documentation that doesn’t explain how this relates to existing sites.

Thank you for any help.

---

<div class="post-metadata">

**Author:** ![stml](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.getkirby.com/stml/32/4028_2.png) [@stml](https://forum.getkirby.com/u/stml)\
**Post date:** [April 4, 2023, 10:12am UTC](https://forum.getkirby.com/t/upgrading-to-kirby-3-creating-a-panel-help-needed/28295/2 "2023-04-04T10:12:31Z")

</div>

Even better - are there any sample blueprints which would mimic the Kirby 2 panel in Kirby 3? This seems like something quite obvious that somebody would have made?

---

<div class="post-metadata">

**Author:** ![jimbobrjames](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.getkirby.com/jimbobrjames/32/5802_2.png) [@jimbobrjames](https://forum.getkirby.com/u/jimbobrjames)\
**Post date:** [April 4, 2023, 11:49am UTC](https://forum.getkirby.com/t/upgrading-to-kirby-3-creating-a-panel-help-needed/28295/3 "2023-04-04T11:49:23Z")

</div>

I would suggest maybe watching some of the Videos on the youtube channel, like this one

[![](https://img.youtube.com/vi/yK3gNjWU_5s/maxresdefault.jpg "Your first blueprints") ](https://www.youtube.com/watch?v=yK3gNjWU_5s)

Theres a few other videos on the channel that i think would be useful like this one

[![](https://img.youtube.com/vi/v3kXDBT6ZCw/maxresdefault.jpg "How to build a project page") ](https://www.youtube.com/watch?v=v3kXDBT6ZCw)

[![](https://img.youtube.com/vi/op5iP71Bg6w/maxresdefault.jpg "How to build a project grid") ](https://www.youtube.com/watch?v=op5iP71Bg6w)

That might help to clear things up for you.

---

<div class="post-metadata">

**Author:** ![stml](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.getkirby.com/stml/32/4028_2.png) [@stml](https://forum.getkirby.com/u/stml)\
**Post date:** [April 4, 2023, 6:42pm UTC](https://forum.getkirby.com/t/upgrading-to-kirby-3-creating-a-panel-help-needed/28295/4 "2023-04-04T18:42:43Z")

</div>

Thank you. Is there anywhere this is written down, rather than in video form?

---

<div class="post-metadata">

**Author:** ![texnixe](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.getkirby.com/texnixe/32/5754_2.png) [@texnixe](https://forum.getkirby.com/u/texnixe)\
**Post date:** [April 4, 2023, 7:38pm UTC](https://forum.getkirby.com/t/upgrading-to-kirby-3-creating-a-panel-help-needed/28295/5 "2023-04-04T19:38:13Z")

</div>

There’s a lot of documentation about blueprints, but there is no such thing as a Kirby 2 to Kirby 3 comparison. What we stopped documenting after all these years but still exists is the so called presets, which sort of mimicked a typical Kirby 2 setup. They are still documented in the Kirby 3.5 archive ([Presets | Kirby CMS](https://v35.getkirby.com/docs/guide/blueprints/presets))

Other than that:

> **[Introduction](https://getkirby.com/docs/guide/blueprints/introduction)**
>
> Blueprints are configuration files written in YAML that let you customize the Panel to make it truly yours.

> **[Page blueprint](https://getkirby.com/docs/reference/panel/blueprints/page)**
>
> Page blueprints are located in /site/blueprints/pages and control the Panel setup and form fields for pages.

> **[Site blueprint](https://getkirby.com/docs/reference/panel/blueprints/site)**
>
> The Site blueprint is located in /site/blueprints and controls the Panel setup and form fields for the site/dashboard.

The site.yml blueprint is where you usually start when you enter the Panel.

Another good starting point is the Starterkit.
