You can use Builder CMS Data to create structured reusable data across your site. You can manage the data schema, add, and remove fields within the UI and teammates can create and remove data items in auto-generated structured forms.
Examples include:
- Header navigation links
- Product Details
- Blog authors
- Structured rich content such as user profiles
This tutorial shows you how to add editable navigation links to your site header.
To follow along with this tutorial, you should have the following:
- a Builder account
- an app in the framework of your choice with the appropriate SDK installed
Create a page with the following contents, replacing YOUR_API_KEY with your account's Public API Key:
// pages/your-page.jsx
import { builder } from "@builder.io/react";
import { GetStaticProps, GetStaticPaths } from "next";
// TO DO: Replace with your Public API Key.
builder.init(YOUR_API_KEY);
export async function getStaticProps() {
const links = await builder.getAll("nav-link", {
// Add options for queries, sorting, and targeting here
});
return {
props: {
links: links || null,
},
};
}
export default function Home({ links }) {
return (
<>
<header>
<nav>
{links.map((link, index) => (
<a key={index} href={link.data.url}>
{link.data.label}
</a>
))}
</nav>
</header>
{/* <RestOfYourPage /> */}
</>
);
}
In the Builder UI, create a Data model so you can create navigation links.
- In the Models section of Builder, Click +Create Model.
- Select Data.
- Enter Nav link as the name for your new Data model.
- Click +New Field.
- Name the first field
labeland give it a type ofText. - Repeat steps 3 and 4 to make a second label named
Urlwith typeurl. - Click Save.
Use the new Data model to create Nav Link content entries.
- Go to the Content section of Builder.
- Click +New.
- Select Nav Link.
- Give it a label, url, and name.
- Click Publish.
To make more links so that you can iterate through the links in your nav list, click the three dots and select Duplicate. Repeat steps 2-4 for each link you create.
The video below shows how to make three Nav Link entries.
Go back to your website and refresh the page to see your nav links. After your links are rendering, try adding new content entries in Builder. For each new entry, the new link populates the nav.
When working with structured data, it's important to set up live previewing to see real-time updates in the Visual Editor without publishing. This is especially useful for dynamic content like navigation links.
For detailed information and examples, read Live Previewing Data Models and Custom Fields.
For more information on how to work with Models in Builder, refer to Understanding Content Models.