Building a Navigation Menu Using a Collection

Menu items are important for navigating through your site, but they can be a headache to build and maintain as they get more intricate. Luckily Butter has a powerful tool for easily creating menus and sub-menus that you can change on the fly! Here's how to build menus in Butter.

Step 1: Creating your Collections

Let's look at how we can create an actual menu that looks like this:

undefined

Here's the hierarchy of our menu:

  •  Solutions
    • Ecommerce
    • Agencies
    • SAAS
    • Marketplaces
  • Features
    • Flexible Content Modeling
      • Components
      • Page types
      • Collections
      • Blog Engine
      • Reference Fields
      • Repeater Fields
    • Fast Content Updates
      • SEO
      • Revision History
      • WYSIWYG
      • Content scheduling
      • Localization
      • Preview Changes
    • Media Library + Content CDN
      • Audio Support
      • Fast Tag
      • In-browser editing
      • CDN for assets
      • Images API
      • Image Editor
    • Multi-Sites and Environments
      • Multiple Websites
      • Multiple Environments
      • Data Migration
    • Developers
      • Content API
      • Globally Cached API and Content for performance, resiliency, and scalability
      • Write API
      • Developers Guide
      • SDK
    • Team Based
      • User Dashboard
      • Roles permissions
      • Workflows
  • Learn
    • Docs
    • Blogs
    • Knowledge Base
    • Butter vs WordPress
  • Pricing

In this example, we will be using Collections - which is a global piece of content. You can model them out in any way you want and give them their own custom set of fields. It has its own API key, which means you can also use it across all of your pages. Navigation menus are global items, so they are a great fit for Collections.

Let's get started! The first step is to create a Collection and call it something like "Menu - First Level."

Menu - First Level.jpg

Now that we've named the collection, the second step is to start building the base configuration of this collection. Some important fields to add would be the "Menu Item Label" which is the display text, and the "URL Slug" which is what the item links to. You can add other fields to it should you wish, but make sure to include the ones I just mentioned.

undefined

When you're happy with the base configuration for your first collection, save it, and repeat the same steps for each level of your menu. Remember to create one Collection for each level of your menu and sub-menu.

Menu - Second Level Configuration.jpg

Menu - Third Level Configuration.jpg

Step 2: Adding items to your Collection

To add an item to any Collection, just click on the green +Add to (Collection Name) button.

undefined

Below is the interface where you can modify the content for each item in a Collection. As we said before, our Menu Item Label is the text to be shown on the menu, and the URL is the link it will follow. 

undefined

When done this is how your Collections would look like:

undefined

Step 3: Adding Reference Fields to your Collection's configuration

Reference Fields give you the option of easily making a menu with as many layers as you want. Now that we have created a Collection for each level of our menu and we have entered all the items for each Collection, let's go back to the configuration page of each Collection that requires a sub-menu, and add "Child Items" which is a Reference Field to other [sub]menu items.

For our example, we need to add a Child Items Reference Field that has a One-to-Many relationship so that we can link an item to multiple Child Items. We also want to make sure that it "references" the right collection.

undefined

Step 4: Linking items from one Collection to another

To choose the correct Child Items, all we have to do is click on the Add reference button then highlight all of the items we want to be in the sub-menu.

undefined

Collections are a powerful tool that Butter uses to help developers build great looking websites quickly. With a Collection item and a few reference fields, you can create menus as complex as you would like. The icing on the cake is these complex menus look however you want.

Still have a question?

Our Customer Success team is standing by to help.