Smuves Documentation

How Smuves reduces HubSpot Content Update Timedont add any text logos etc-3

What Smuves Does

Smuves is a content engineering platform that connects to your HubSpot CMS and lets you manage website content in bulk. Instead of editing pages one by one inside HubSpot, Smuves pulls your entire content dataset into a searchable, filterable data table where you can make changes across hundreds or thousands of records at once.

With the Smuves and HubSpot integration, you can:

  • Fetch and browse all your CMS content types (pages, blog posts, landing pages, authors, tags, redirects, HubDB tables) in one place
  • Search, sort, and filter across all records instantly
  • Bulk edit multiple fields across multiple records at once
  • Find and replace text across your entire content library
  • Export content data to CSV or Google Sheets for review
  • Import changes back to HubSpot with a single action
  • View detailed activity logs of every change made

Smuves only works with CMS content. It does not modify CRM objects like contacts, companies, or deals.

Prerequisites

Before you install Smuves, make sure you have the following:

  • A HubSpot account with CMS Hub (Starter, Professional, or Enterprise). Smuves works with all CMS Hub tiers.
  • Super Admin permissions in your HubSpot account, or at minimum, permissions to install apps and access CMS content.
  • A modern web browser (Chrome, Firefox, Edge, or Safari). Smuves runs entirely in the browser.

You do not need any coding knowledge, API credentials, or developer tools to use Smuves.

Step 1: Create Your Smuves Account

  1. Go to app.smuves.com to open the signup screen.
  2. You will see three tabs at the top: Magic link, sign Up, and sign In.
  3. You can use any of the following methods to create your account:
    • Magic Link: Enter your email address and click Send Magic Link. Smuves will send you a secure login link via email. No password needed. You can optionally enter your full name as well.
    • Sign Up: Switch to the Sign Up tab and create an account with your email and a password.
    • Continue with Google: Click the Google button at the bottom to sign up using your Google account.
  4. Once signed in, you will be taken to the Smuves dashboard. At this point, no HubSpot portal is connected yet.

Step 2: Connect Your HubSpot Account

  1. After signing in, the Smuves dashboard shows a Content Overview section with a "HubSpot Not Connected" message and a Connect HubSpot button. Click that button.
  2. A Connect Your HubSpot Account modal will appear. You have two options to connect:
    • HubSpot Private App Token: Paste your HubSpot Private App Token into the input field on the left side of the modal. You can generate a Private App Token from your HubSpot account under Settings > Integrations > Private Apps.
    • Sign in with HubSpot (OAuth): Click the Continue with HubSpot button on the right side of the modal. This will redirect you to HubSpot's authorization screen where you can review the permissions Smuves is requesting and select which HubSpot account to connect.
  3. Click Test & Save CMS Connection to verify and save the connection.
  4. Once the connection is successful, you will be taken back to the dashboard where your content overview will start populating.

Important: Smuves uses OAuth to connect to HubSpot. This means your HubSpot credentials are never stored by Smuves. HubSpot handles the authentication, and Smuves receives a secure access token that it uses to communicate with HubSpot's APIs on your behalf.

Step 3: View Your Content Overview and Fetch Data

Once your HubSpot portal is connected, the dashboard shows a Content Counts table with an overview of your non-archived content assets. This table lists each content type (Authors, Blog Posts, Blogs, Landing Pages, Tags, URL Redirects, Website Pages) along with their Published, Draft, and Total counts. Click Refresh Data on the dashboard at any time to update these counts.

The dashboard gives you a high-level summary, but to actually work with your content records, you need to fetch the data.

  1. Click Exports in the left sidebar to go to the Content Manager.
  2. Use the content type dropdown in the top right (e.g., Blog Posts, Website Pages, Landing Pages) to select which content type you want to work with.
  3. Click Fetch to pull the records for that content type from your HubSpot portal.
  4. Depending on the number of records, this may take a few seconds to several minutes.
  5. Once the fetch is complete, your content records will appear in the data table below, ready for you to search, filter, and edit.

Note: Smuves fetches a snapshot of your content at the time of the fetch. If content changes in HubSpot after that, you can fetch again to pull the latest data.

Step 4: Filter and Configure Your View

Once your content is fetched, the Content Manager provides several ways to narrow down and organize your data.

  1. Expand the Filters panel to filter records by various fields relevant to the content type you are viewing. The available filters change depending on the content type selected. Select your filter values and click Apply Filters to update the view. Click Clear All Filters to reset.
  2. Use the content type dropdown in the top right to switch between different content types (Website Pages, Blog Posts, Landing Pages, etc.).
  3. Use Sort to order your records by any visible column.

Step 5: Edit Content in Bulk

Smuves offers several ways to edit content. All editing actions start by selecting records and using the Actions dropdown in the top right corner of the data table. The Actions menu gives you four options: Export, In App Edit, Find & Replace, and Manage Publish State.

In App Edit (Bulk Editing)

  1. Select the records you want to edit by checking the checkboxes next to each row. You can also click Select All to select every record in the current view.
  2. Click the Actions dropdown and select In App Edit.
  3. This opens an editing view where you can modify fields across all the selected records at once.
  4. Make your changes and save them. The updates will be pushed to HubSpot as drafts.

Find and Replace

  1. Select the records you want to search across.
  2. Click the Actions dropdown and select Find & Replace.
  3. A modal will open with two tabs: Find and Find & Replace.
  4. The Find tab lets you search for text within your selected content. Enter the text you are looking for in the Find field, select which column to search in using the In dropdown, and optionally toggle Match Case or Search Empty Cells. Click Find to see the results.
  5. Switch to the Find & Replace tab to replace text. Enter the text you want to find in the Find field and the replacement text in the Replace With field. Select the column to search in using the In dropdown.
  6. Click Preview Changes to see exactly which records will be affected and what the changes will look like before applying them.

Export

  1. Select the records you want to export.
  2. Click the Actions dropdown and select Export.
  3. An Export Content modal will open. Choose your export method from the three tabs at the top:
    • Export to Google Sheets: Sends the selected records directly to a Google Sheet.
    • Export to File: Downloads the data as a file (CSV).
    • Export to JSON: Downloads the data in JSON format.
  4. Below the export method tabs, you can choose which fields to include in the export. Fields are organized into three groups: Required Fields (always included, some are read-only), Recommended Fields (commonly used fields like Author Name, Meta Description, Html Title), and Additional Fields (all other available properties). Use the Deselect All button on each group to quickly toggle fields on or off.
  5. Click the export button to complete the export.

You can then edit the exported data externally and import it back into Smuves. Click Imports in the left sidebar, upload the modified file, and Smuves will show you a diff of what changed before pushing updates to HubSpot.

Manage Publish State

  1. Select the records whose publish state you want to change.
  2. Click the Actions dropdown and select Manage Publish State.
  3. This lets you change the publish status of the selected records in bulk.

Step 6: Review Activity Logs

Every action you take in Smuves is logged for transparency and accountability.

  1. Click Logs in the left sidebar.
  2. You will see a chronological record of all operations: fetches, edits, imports, and exports.
  3. Each log entry shows who performed the action, what changed, when it happened, and which records were affected.

Connecting Multiple HubSpot Portals

If you manage content across more than one HubSpot account (common for agencies), Smuves supports connecting multiple portals.

  1. In the left sidebar, click the Portal ID dropdown to expand it. This shows your Connected Portals list with each portal's ID and status (Active).
  2. Click + Add Portal at the bottom of the list.
  3. The Connect Your HubSpot Account modal will open (the same one from Step 2). Enter a Private App Token or click Continue with HubSpot to connect via OAuth, then click Test & Save CMS Connection.
  4. Once connected, the new portal will appear in your Connected Portals list. Click on any portal in the list to switch to it.
  5. Each portal's content is kept separate. Fetching and editing are scoped to the currently selected portal.

Disconnect Your HubSpot Account from Smuves

If you no longer want Smuves connected to your HubSpot account:

  1. In the left sidebar, click the Portal ID dropdown to expand the Connected Portals list.
  2. Click the arrow (>) next to the portal you want to disconnect.
  3. From the portal details, disconnect the portal.
  4. Confirm the disconnection when prompted.

What happens when you disconnect:

  • Smuves will no longer be able to read or write content in your HubSpot account.
  • Any content that was already edited and pushed to HubSpot will remain in HubSpot as-is. Disconnecting does not revert changes.
  • No data is deleted from your HubSpot account when you disconnect Smuves.

Uninstall Smuves from HubSpot

To fully remove Smuves from your HubSpot account (not just disconnect):

  1. In your HubSpot account, click the Settings icon (gear icon) in the main navigation bar.
  2. In the left sidebar, navigate to Integrations then Connected Apps.
  3. Find Smuves in your list of connected apps.
  4. Click Uninstall.
  5. Confirm the uninstallation.

This revokes all OAuth tokens and removes Smuves's access to your HubSpot account entirely. Super admins in your account will receive an email notification confirming the uninstall, with a link to reinstall if needed.

For more details on uninstalling apps, refer to HubSpot's Knowledge Base article on uninstalling connected apps.

What happens when you uninstall:

  • All OAuth access tokens are revoked immediately.
  • Smuves can no longer communicate with your HubSpot account in any way.
  • Content already edited in HubSpot remains unchanged. Uninstalling does not revert any changes.
  • Activity logs stored in Smuves remain accessible if you log into Smuves directly, but interacting with your HubSpot content would require reconnecting and re-authorizing the app.

Pricing Plans and the HubSpot Integration

Smuves offers three tiers. All tiers include the HubSpot integration.

Free ($0 per month) Bulk Fetch 100 records. Bulk Edit 50 records. Perfect for small teams and simple edits.

  • Single platform connection
  • Content type counts
  • HubSpot Integration
  • Google Sheets Integration
  • Fetch content types one at a time
  • Filter, search, sort records
  • Find and replace (non-module fields)
  • Execution Logs

Pro ($99 per month) Bulk Fetch 1,000 records. Bulk Edit 500 records. Perfect for larger websites or frequent edits.

  • Everything in Free

Enterprise ($249 per month) Bulk Fetch 50,000 records. Bulk Edit 10,000 records. Perfect for agencies or mega websites.

  • Everything in Pro
  • Multi-platform connection
  • Fetch all content types at once

For full pricing details, visit smuves.com/pricing.

Need Help?

If you run into issues or have questions about setting up Smuves with HubSpot: