How to Use HubDB Tables in Hubspot
Hubspot gives you a powerful way to manage structured website content using HubDB tables. With HubDB, you can centralize data such as product catalogs, team directories, events, and more, then display that information dynamically on Hubspot pages and templates.
This step-by-step guide walks you through creating, editing, importing, and using HubDB tables inside Hubspot so you can build scalable, data-driven content.
What Is HubDB in Hubspot?
HubDB is a relational-style data table feature available within Hubspot CMS. It lets you store rows and columns of structured data and reference that data in:
- Website pages
- Landing pages
- Custom modules and templates
- Serverless functions and APIs
Each HubDB table in Hubspot is made up of:
- Columns that define the data type, such as text, number, URL, image, or select options.
- Rows that represent individual records, such as a single product, location, or team member.
Because HubDB is integrated directly into Hubspot, you can update data centrally and reuse it across multiple pages.
How to Create a New HubDB Table in Hubspot
Follow these steps to create a new HubDB table in your Hubspot account.
Step 1: Open the HubDB tools in Hubspot
- Sign in to your Hubspot account.
- In the main navigation, go to Marketing > Files and Templates > HubDB (or the CMS section where HubDB is listed, depending on your subscription and UI).
- You will see a dashboard listing your existing HubDB tables.
Step 2: Create a new HubDB table
- Click the Create table button.
- Enter a clear Table name that describes the content, for example, “Product Catalog” or “Team Directory”.
- Optionally add a description so other Hubspot users understand how the table should be used.
- Confirm to create the table. Hubspot will open the new table in an editor view.
Step 3: Configure HubDB columns in Hubspot
Next, set up columns to define the structure of your HubDB table.
- In the table header, click Add column.
- Give your column a clear label, such as name, price, image, or location.
- Choose a column type. Common HubDB column types in Hubspot include:
- Text – for names, titles, or descriptions
- Number – for prices, quantities, or rankings
- URL – for external links
- Image – for images stored in the Hubspot file manager
- Select – for predefined options
- Date – for event dates or schedules
- Save your new column.
- Repeat for each data field you need.
Hubspot automatically adds a unique ID column for each row, which you can use when querying HubDB via API or in templates.
Adding and Managing HubDB Rows in Hubspot
Once your table structure is ready, you can begin entering data into Hubspot.
Manually add rows to a HubDB table
- Open the relevant HubDB table in Hubspot.
- Click Add row.
- Fill in each cell according to your column definitions. For example:
- Product name (text)
- Price (number)
- Product image (image)
- Detail page URL (URL)
- Click Save or allow Hubspot to autosave your changes.
Edit and delete HubDB rows
To keep your content up to date in Hubspot, you can easily edit or remove existing rows.
- Click directly into any cell to edit its contents.
- Use row actions (such as a more options menu) to:
- Duplicate a row
- Delete a row
- Reorder rows where supported
Changes to published HubDB tables will automatically reflect wherever the table is used in Hubspot templates or modules.
Importing and Exporting HubDB Data in Hubspot
If you already maintain structured data in spreadsheets, Hubspot lets you import that data into a HubDB table.
How to import CSV data into HubDB
- Prepare a CSV file that matches your desired table structure. Ensure column names and data types are consistent.
- In Hubspot, open your target HubDB table or create a new one.
- Click Import in the table interface.
- Upload your CSV file.
- Map CSV columns to HubDB columns in Hubspot. Confirm that text, number, URL, and image fields match correctly.
- Complete the import. Hubspot will create or update rows according to the mapped fields.
Export HubDB table data
You can also export HubDB content from Hubspot for reporting, backup, or offline editing.
- Open the HubDB table.
- Click Export.
- Choose your export format (typically CSV).
- Download the file and open it in your spreadsheet tool.
After editing the CSV, you can re-import it to update data in Hubspot using the mapping steps above.
Using HubDB Tables on Hubspot Pages
The main benefit of HubDB in Hubspot is using table data to power dynamic content on your website and landing pages.
Connect HubDB to Hubspot templates
Developers and advanced users can reference HubDB tables in coded templates or custom modules using HubL and the Hubspot design tools.
- Loop through rows to output repeating content such as:
- Event listings
- Location directories
- Pricing tables
- Resource libraries
- Filter rows based on column values, such as category, date, or region.
When you update a HubDB row in Hubspot, any templates using that table will update automatically without editing the page itself.
Use HubDB with dynamic pages in Hubspot
Hubspot supports dynamic pages driven by HubDB tables. Each row can become its own page, ideal for items like:
- Individual product detail pages
- Team member bios
- Location profile pages
To set this up, a Hubspot developer creates a dynamic page template linked to a HubDB table. The template then uses row-specific data (such as name, image, or description) to render each unique page.
Best Practices for Managing HubDB in Hubspot
To keep your HubDB implementation scalable and easy to maintain in Hubspot, follow these best practices:
- Plan your schema first: Map out columns and data types before building pages.
- Use clear naming: Name columns and tables so other Hubspot users understand their purpose.
- Keep data normalized: Avoid duplicate information across multiple tables where possible.
- Limit manual edits: For large datasets, rely on CSV import and export to reduce errors.
- Document usage: Add descriptions so teams know which Hubspot pages depend on each table.
Where to Learn More About HubDB in Hubspot
For deeper technical details, API usage, and developer code samples, review the official Hubspot documentation on HubDB tables at this HubDB knowledge base article.
If you need expert implementation help with Hubspot, strategy, or CMS development, you can also explore consulting resources such as Consultevo for additional guidance.
By combining structured HubDB tables with Hubspot templates and dynamic pages, you can manage complex content at scale while keeping everything centralized, consistent, and easy to update.
Need Help With Hubspot?
If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.
“`
