Last updated 22 November 2010. Created on 18 December 2007.
Edited by chriscalip, GoddamnNoise, texas-bronius, dkinzer. Log in to edit this page.

The Panels 2 module is the core engine for a number of sub-modules, including Panels pages, Panels nodes, Mini panels, and Views panes. Panels module allows the website administrator (or sometimes the end-user) to manipulate the layout of individual pages, sidebars, and content pieces, as well as easily dictate what content is displayed in the layout.

Most Drupal users are familiar with the block to region layout mechanism in which you can assign a block to any region defined in your theme. Panels takes this concept a massive step forward. Through the panels interface you can start by creating a layout with any number of columns, headers, and footer, and control the width of those areas.

After creating your layout, you can assign pieces of content to those areas in an easy drag and drop interface. Content is not limited to blocks, but can be nodes, views, or other types of content that expose themselves to panels.

Panel pages are the primary panels module, you can use this for creating single full page layouts. This replaces the standard panel that existed in the earlier versions of panels. If you are upgrading your site from Panels 1, and you cannot find where your panels went, be sure to enable the panel pages module!

Panel nodes are useful for creating layouts that only occupy the content area of your pages. Frequently, it is desirable to add an area to a node layout, such as a pull quote for a newspaper or a photo block, that you don't necessarily want on every node. Panels Nodes lets you control the layout of a single node at a time and place content such as blog posts, images, blogs in and around the post.

Mini panels are a layout mechanism for blocks. It won't take long using panels before you get to a point when you want a panel inside of a panel. Or a panel that can be used as a block. That is exactly what mini-panels does. You can create a small panel here with various pieces of content and then put it inside of a panels-page or panels-node.

Views panes expose views so they may be added to panels. Panels will automatically detect block views without this module; however, page and embedded views will not be selectable from Panels by default. If you enable the Views panes module, you may expose individual views to Panels. The Legacy views panes module will simply expose all views, so that you may add them in any panel. Both modules provide options for customization of the views' settings on a per-Panel basis. This is useful if you have multiple administrators or want to use panels for something other than just panel pages

There are several terms used often within panels that administrators should become familiar with:

  • Panel Page An actual page that your panels will be in. This could be the front page of a site, a news page, etc. These pages are given a path just like any other node.
  • Panel A container for content. A panel can have several pieces of content within it, and each piece can have its own styles.
  • Pane A unit of content in a panel. This can be a node, view, arbitrary HTML code, etc. Panes can be shifted up and down within a panel and moved from one panel to another.
  • Layout Provides a pre-defined collection of panels that you can select from. A layout might have two columns, a header, footer, and three columns in the middle, or even seven panels stacked like bricks. API documentation for building plugins is also available.

Below is a rough idea of the sections planned for Panels 2 documentation, which is under active development. (Unlinked sections are forthcoming.) If you feel confident in your Panels 2 knowledge, please don't hesitate to help fill things in. Also see the group discussion for panels documentation.

Panel 2 documentation

  • Panels basic options
  • Panels displays
  • Panel pages
  • Panel nodes
  • Mini panels
  • Panels arguments
  • Panels context
  • API documentation

Available Tutorials

See also

Looking for support? Visit the forums, or join #drupal-support in IRC.


vspurlin’s picture

In the bullet item "# Panel A container for content. A panel can have several pieces of content within it, and can have their its styles", what's the meaning of "and can have their its styles"? Would it be better to say "and each piece can have its own styles"? Not sure if I got the meaning correct.

GoddamnNoise’s picture

The link Oregon State video on creating a page using panels is broken. If you click on it, you'll see a "Page not found" message. I think it should be removed.

Marcelino’s picture

the above link is broken can u please fix it..

shamio’s picture

Who introduced this link? I don't see this link at all in this section and i think you wrote the link and you wrote that its broken too.