Search is no longer just about ranking pages. These FAQs cover SEO, AI, AEO, schema, answer readiness, and the practical choices that help your content become easier for people and search systems to understand.
Still can’t find what you are looking for? Try
ChatGPT.
What is the first step in AEO?
The first step in AEO is not schema, automation, or a full technical overhaul. Start by choosing one high-value buyer question and answering it clearly near the top of the page. Once the answer is clear, strengthen it with proof, practical context, related internal links, and technical checks that make sure the page can be crawled, indexed, and understood.
AEO does not require special AI-specific structured data. Current Google guidance says the same SEO fundamentals apply to AI features in Search, and there is no special schema required for AI Overviews or AI Mode. Structured data can still help when it accurately describes visible page content, such as Article, BlogPosting, Organization, Person, BreadcrumbList, or FAQPage markup where visible FAQs exist.
How does SW SEO Schema get organization information?
SW SEO Schema is a theme partial that outputs structured data using HubSpot site settings and brand settings. The documentation points to Marketing → Email → Footer addresses for company name and address details.
For the organization URL, set the Logo URL on the default logo in Content → Brand → Logos. The same email footer address fields can affect Organization structured data such as company name, street, city, state, postal code, and country.
Why does Google show the wrong organization URL or missing address for my site?
If Google shows the wrong organization URL or missing address information, review the settings that feed the SW SEO Schema partial. Set the Logo URL on the default logo in Content → Brand → Logos so the canonical site URL is available.
Then fill out Marketing → Email → Footer addresses with the company name, street, city, state or region, postal code, and country. The documentation notes that those fields are used for Organization structured data.
How do I set up a HubDB table for SW FAQs Simple?
SW FAQs Simple needs a subset of columns. The same table can later power a FAQ hub if you add hub columns for SW FAQs Advanced HubDB.
Required for Simple (HubDB mode)
Column (API name)
Purpose
name
Internal row label only
question
Visible question
answer
Visible answer (rich text)
page_paths or group_key
Match rows to a page or reusable set
Optional for Simple
related_posts_urls — blog paths; links render with a dot separator between titles
Hub-only columns (add when using Advanced hub)
category, category_order, sort_order
long_answer — for long-only or read-more display modes
subtopic — comma-separated topic tags for hub filter chips
page_paths: root-relative URLs such as /blog/my-post (leading slash; | separates multiple). group_key: same key on rows + module Group Key field.
See also FAQ 096 for the full hub table contract and FAQ 097 for Simple vs Advanced on one table.
What is docs.smithworks.marketing for?
docs.smithworks.marketing is the Smithworks developer documentation hub for SW modules and theme additions. It links to the module index, master changelog, AI-facing module documentation, marketer FAQs, and the client portal.
The site is useful when you need to confirm whether a module is an SW module, review recent changes, check whether a module has alias risk, or find the right documentation path for implementation work.
What is the SW modules master changelog for?
The SW modules master changelog summarizes dated changes to Smithworks modules, templates, partials, and theme files. It is written for people working in HubSpot, not only for internal repositories.
Use it when a module looks different after an update, when a field moves, when a migration note tells you to reopen a module, or when you need to understand why a new setting appeared in the editor.
What does alias risk mean in the SW module index?
The SW module index includes an Alias risk column for modules that need extra scrutiny during upgrades, syncs, or module-path mapping. The docs currently flag SW Cards and SW Pillar Section through the registry.
When a module has alias risk, do not assume the module path, replacement behavior, or upgrade mapping without checking the changelog, registry notes, or developer documentation. It is a prompt for more careful review, not proof that the module is broken.
What is the Smithworks client portal link for in the SW documentation hub?
The Smithworks client portal link in the documentation hub is for reports and account tools. It is not the same as the module index, AI documentation, or master changelog.
Use the docs site for module behavior and implementation references. Use the client portal when the task is related to client reports or account access.
Can SW FAQs Simple output FAQPage schema?
SW FAQs Simple supports optional FAQPage schema for visible FAQ sections. The changelog notes that when a Section heading is set and Output FAQPage Schema is on, the structured-data block can include that heading as the FAQ page name.
Schema should stay aligned with visible content. Do not use FAQPage schema for questions that are hidden from users or unrelated to the page where they appear.