Getting Started

Filtering and Sorting

Search

Use the search bar to filter pages by name, URL, or current title tag. Results update as you type.

Page Type

Filter by All Types, Site Pages, Landing Pages, or Blog Posts using the dropdown.

Status

By default, only Published pages are shown. Switch to Draft to see unpublished pages, or All Status to see everything.

Domain

If your HubSpot portal hosts multiple domains, a domain filter appears automatically. Use it to focus on one site at a time.

Sorting

Sort by Most Recent (last updated) or A–Z (alphabetical by page name).

Pagination

Pages are displayed 25 at a time. Use the pagination controls at the bottom to navigate between pages.

Editing Metadata

There are two ways to start editing:

• Click the field — Click directly on any title tag or meta description to enter edit mode for that row.
• Click Edit — Click the Edit button in the Actions column to edit both fields at once.

While editing, you'll see:

• A text input for the title tag and a textarea for the meta description.
• Character counters that turn red when you exceed the recommended limit.
• Save — Writes the changes directly to HubSpot via their API.
• Cancel — Discards your changes and returns to view mode.

AI Recommendations

How It Works

When you click the sparkle icon on a row, the system:

1. Fetches the live published content of that page using Firecrawl (converted to clean markdown).
2. Sends the page content, current title, current description, and your custom settings to Google Gemini.
3. Gemini analyzes the content and generates an optimized title tag (under 60 characters) and meta description (under 160 characters).
4. The suggestion appears below the row with a side-by-side comparison showing your current metadata (struck through) and the AI suggestion (in bold), along with a brief explanation of the changes.

Accepting or Dismissing

• Accept — Saves the AI suggestion directly to HubSpot, replacing your current title and/or description.
• Dismiss — Removes the suggestion without making any changes.

Bulk AI Recommendations

Click AI All Visible in the header to generate recommendations for every page currently visible on the screen (up to 20 at a time). Each page gets its own suggestion that you can accept or dismiss individually.

Custom AI Settings

Click the Settings button in the header to configure:

• Target Keywords — Enter keywords or topics you want the AI to incorporate into recommendations. For example: "HubSpot consulting, inbound marketing, CRM setup". The AI will weave these in naturally where they fit the page content.
• Custom Instructions — Add specific guidance like "Focus on B2B audience", "Include location Austin TX", "Keep brand name first in titles", or "Use action-oriented language in descriptions".

These settings are saved in your browser and persist across sessions. They're specific to each HubSpot portal, so different portals can have different keywords and instructions.

Page Details

Each row in the table shows:

• Thumbnail — The page's featured image (if set). Hover to see a larger preview.
• Page name — The internal name from HubSpot.
• Full URL — The complete published URL of the page.
• Type badge — Site Page, Landing Page, or Blog Post.
• View link — Opens the live page in a new tab.
• Edit in HS link — Opens the page directly in the HubSpot editor.
• Title Tag — The current HTML title tag (what appears in search results and browser tabs).
• Meta Description — The current meta description (what appears below the title in search results).

SEO Best Practices

Title Tags

• Keep titles under 60 characters to avoid truncation in search results.
• Put your most important keyword near the beginning.
• Make each title unique across your site.
• Include your brand name, typically at the end (e.g., "Page Topic | Brand Name").
• Write for humans first — compelling titles get more clicks.

Meta Descriptions

• Keep descriptions under 160 characters.
• Include a clear value proposition or call to action.
• Incorporate relevant keywords naturally — Google bolds matching terms.
• Make each description unique and specific to the page content.
• Describe what the visitor will find on the page, not just what the page is about.

Frequently Asked Questions