Working with the Box Hubs Builder

The Box Hubs builder provides an intuitive interface for organizing your Hub content. The builder uses the same interaction model as other Box tools, making it easy to learn and use.

​

Before you begin

To organize a Hub, you must have co-owner or editor permissions. For details, see Box Hubs Permissions.

​

Edit your Hub

To open a Hub in edit mode:

1. Go to the Hubs gallery.
2. Select the Hub you want to edit.
3. In the upper-right corner, select Edit.

The Add Block panel appears on the right side. The panel displays all available content block types you can add to your Hub.

​

Logo and header alignment

You can center-align the logo in the Hub builder. When you center-align the logo, the hub name and description are also center-aligned.

​

Content blocks

Content blocks are the building blocks of your Hub. Each block type serves a different purpose:

​

Add a block

Use either method to add a block: Method 1: Click to add

1. In the Add Block panel, select the block type.
2. The block appears at the end of the page.

Method 2: Drag to add

1. In the Add Block panel, drag the block type onto the page.
2. Drop it in the desired location.

​

Manage blocks

To manage a block:

1. Select the block on the canvas.
2. The context toolbar appears with available options:
   • Move up or down
   • Move to a Different Page
   • Duplicate
   • Trash
   • Add Items (for Files and Folders blocks)
   • Display as grid or list (for Files and Folders blocks)
   • Formatting toolbar (for Paragraph and Call Out blocks)

To reposition a block, select it and drag it to the new location.

​

Delete a block

1. Select the block.
2. On the context toolbar, select Trash.

​

Link Cards

The Link Cards block displays a row of customizable cards that link to Hub pages, Box content, or external URLs. When you add the block, three empty cards appear by default. To configure a card, select it, add a link, and edit the title, description, or background image. When you add a link, the card pulls the title, description, and image from the destination if those details are available. Cards that link outside your enterprise show an external link icon and open in a new tab. To manage cards within the block:

• Select Add Card to add a card.
• Select Trash on the card toolbar to remove a card.
• Use the arrows on the card toolbar to reorder cards.

From the block’s context toolbar, switch between Left Align (default) and Fill (full-width) layouts.

​

Images

The Image block adds a graphic directly to your Hub layout, so you can include visuals without relying on a link preview. Each image displays inline and adapts to the layout, keeping its aspect ratio across desktop, tablet, and mobile screens.

​

Add an image

1. In the Add Block panel, select Image or drag it onto the page.
2. In the Image block placeholder, choose one of these sources:
   • Upload from computer — select an image file, such as a JPG, PNG, or GIF, from your device.
   • Upload from Box — select an image already stored in Box using the content picker. You need at least Viewer access to the file.

The image uploads and displays inline within the block. If you add an unsupported file type or a file that exceeds the maximum size, the image isn’t added and an error message explains why. For an upload that fails due to a connection or server error, select Retry.

​

Set the aspect ratio and crop

After you add an image, it displays at its original size. To frame it, select an aspect ratio from the image toolbar:

• Original — keeps the image’s original proportions. This is the default.
• Portrait — 3:4
• Square — 1:1
• Wide — 16:9
• Extra Wide — 21:9

When you select an aspect ratio other than Original, the image is cropped to that ratio from the center, and the toolbar displays an Adjust button. To reframe the image within the ratio, select Adjust, drag the slider to change how the image fills the frame, and then select the checkmark to apply. The aspect ratio stays fixed as you adjust. If you change the aspect ratio or replace the image, the crop resets to the center so you can adjust it again. To swap in a different image, select Change Image on the toolbar.

​

Resize an image

To resize an Image block, drag its top or bottom edge up or down. As you drag, the block moves through the preset aspect ratios — Portrait, Square, Wide, and Extra Wide — and snaps to the nearest one when you release. This is an alternative to selecting a ratio from the toolbar.

​

View an image full screen

When viewing a Hub, select an image to open it in full-screen mode.

​

Sections

Sections help you organize related content by creating visual separators on your page. Each section title marks the beginning of a new section.

​

Create a section

1. In the Add Block panel, select Section Title or drag it onto the page.
2. Enter a section title (up to 100 characters).
3. Add content blocks to your section.

When you add a section title, an outline is created automatically in the Hub navigation. This makes browsing easier for viewers.

​

Reorder sections

1. Select the section title.
2. In the context toolbar, select Move Up or Move Down.
3. Move the section to the desired position.

​

Rename a section

1. Select the section title.
2. Enter the new title.

​

Delete a section

1. Select the section.
2. In the context toolbar, select Trash.

​

Pages

Pages provide another level of organization in your Hub. You can create multiple pages and nest them to build a clear hierarchy.

​

Display pages horizontally or vertically

As an editor, you can display your Hub’s pages in one of two layouts. Choose the one that fits your Hub: Switching between layouts changes only how viewers navigate. Your page content and hierarchy stay the same. To switch, open your Hub in edit mode and click the display icon next to the page list. Its tooltip shows the layout it switches to:

• Display pages horizontally () — moves the pages into a tab bar across the top.
• Display pages vertically () — returns the pages to the outline along the side.

In the vertical layout:

• Nested pages display indented under their parent page.
• To reorder pages, drag a page up or down.
• To open a page, select it in the outline.

In the horizontal layout:

• Nested pages display under their parent tab.
• To reorder pages, drag a tab left or right.
• To open a page, select its tab.

​

Add a page

1. In the Hub outline panel (when pages display vertically) or tab bar (when pages display horizontally), select Add Page (+).
2. Replace the default title with your page name.

The default title format is “Untitled Page [yyyy-mm-dd hh:mm:ss].”

​

Add a nested page

Nested pages (subpages) appear under a parent page in the hierarchy.

1. In the Hub outline panel (when pages display vertically) or tab bar (when pages display horizontally), hover over the parent page.
2. Select the ellipsis (…) to open the page options.
3. Select Add Nested Page.
4. Enter a title for the nested page.

​

Duplicate a page

1. In the Hub outline panel (when pages display vertically) or tab bar (when pages display horizontally), hover over the page.
2. Select the ellipsis (…) to open the page options.
3. Select Duplicate Page.

​

Change page hierarchy

You can reorganize your pages at any time:

• Reorder pages: In the Hub outline, drag a page up or down. In the tab bar, drag a tab left or right.
• Create nested pages: Drag a page onto another page to make it a subpage.
• Promote nested pages: Drag a subpage into the main page area to make it a top-level page.

​

Delete a page

1. In the Hub outline panel (when pages display vertically) or tab bar (when pages display horizontally), hover over the page.
2. Select the ellipsis (…) to open the page options.
3. Select Delete Page.
4. In the confirmation dialog, select Delete.

​

Notify collaborators of changes

After you make changes to your Hub, you can notify all collaborators through email.

​

Send a change notification

1. Make your changes to the Hub.
2. In the upper-right corner, select Save > Save & Notify Collaborators.
3. In the notification dialog, enter a message describing your changes.
4. Select Save & Notify.

All Hub collaborators receive an email notification with your custom message and a link to open the Hub. As the sender, you do not receive this email notification.

​

Save without notifying

If you don’t want to notify collaborators:

1. Make your changes to the Hub.
2. In the upper-right corner, select Save.

Your changes are saved, but collaborators don’t receive an email notification.