Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.box.com/llms.txt

Use this file to discover all available pages before exploring further.

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.
Hub builder.png

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:
Block typeDescription
Files and FoldersAdd content from your Box account.
Section HeaderCreate an organizational section with a title (up to 100 characters).
ParagraphAdd text content (up to 5000 characters).
Call OutHighlight important information in a new call out window (up to 5000 characters).
Link PreviewEmbed interactive content directly in your Hub.
Link CardsAdd a block that displays a set of cards, each linking to a configurable destination.
DividerAdd a visual separator between content.

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)
    • Layout options (for Link Cards blocks)
To reposition a block, select it and drag it to the new location.
NoteIn Files and Folders blocks, individual files become draggable only after you select the block. This prevents accidental movement.
  • List view: Drag and drop files or folders to reorder them.
  • Grid view: Select a file or folder, click the (three dots) at the bottom of the card, and click the Move Left or Move Right arrow.

Delete a block

  1. Select the block.
  2. On the context toolbar, select Trash.
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.
Notes
  • The Link Cards block must contain at least one card. When you remove the last card, the entire block is deleted from the page.
  • If you save the Hub with a card that has no link added, that card isn’t shown when viewers open the Hub.
ImportantHub access does not automatically grant viewers access to the destination of a card. If a viewer does not have access, they see the standard error state on the destination page.

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.

Add a page

  1. In the Hub Outline panel, 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, 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, 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: Drag a page up or down to change its position.
  • 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.
NoteYour home page is always the highest page in the hierarchy and can’t be moved.

Delete a page

  1. In the Hub Outline panel, hover over the page.
  2. Select the ellipsis (…) to open the page options.
  3. Select Delete Page.
  4. In the confirmation dialog, select Delete.
ImportantWhen you delete a page, all content within it is deleted, including blocks and nested pages. This action can’t be reversed.

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.