Connect guides and product pages
Add related products to documentation and blog articles, then link products back to useful buying and care guides.
A guide answers a question that a product card cannot: how to choose, compare, use or care for an item. Write the explanation once, then connect it to the products it helps visitors understand.
This creates a useful route from an explanation to a product and then to an inquiry; it does not add a shopping cart or checkout.
The guide's product list and a product's guide list are separate choices. Adding one does not automatically create the other. Save and publish each direction you want visitors to use.
Start with published products in the same site and language, a useful guide topic, and permission to edit and publish both kinds of content. Use verified facts and images you have permission to publish. Any demonstration measurements should be clearly marked as illustrations.
Write a document or blog article
For a task-focused guide, open Documentation. If the site has no document tree, create its root first, then add the guide. In an existing tree, use Add Document; an empty tree can show Create Document. Keep existing documents in their current tree unless you intend to reorganize them. Write a clear title, short introduction and structured body. Explain the answer near the beginning, then add sections, an image or a compact comparison table where helpful.
For an editorial article, open Blog Posts, select Create Blog Post, fill in the initial fields and choose Create & Edit. The product-reference controls described below are available for both documents and blog posts.
Do not add a second top-level heading to the body when the page already displays the document or article title. Keep general advice in the guide and product-specific differences on the product page.
Add the products the guide discusses
Find Products mentioned in this guide and select Add product references. Set Products heading and, if useful, Products introduction (optional).
Under Find products, search and select Add for the relevant items. You can select up to 24 distinct products from the same site and language. Use the earlier/later arrows to set their display order. Review Product image fit, Product link label, and Unavailable image label.
The readiness line explains which version visitors will see. Published version used · draft changes stay private means the published target is used while its newer edits remain private. A draft target must be published before you publish content that references it.
Select Save, then Open authorized preview to inspect the saved guide. Check the body, images, table and related-product cards. Select Publish when the guide is ready, then open the public URL and follow its product links. The action can read View published when there are no pending edits.
A guide can reference published products while newer product drafts remain private.
Visitors can follow the guide to either demonstration product. Return links on the products are configured separately.
Add return links on the products
Open a product and find Product guides, below its inquiry settings. Select Add guide references and set Guides heading.
Choose Documentation or Blog articles in Guide type, use Find guides, and select Add for the published guide. You can choose up to 12 distinct guides in total and arrange their order with the arrow controls. A single guide can be selected on several products without duplicating its text.
Under Layout & SEO, retain the Product details block and keep Show product details enabled. The guide links are displayed inside that block. If it was removed, use Add product details block.
Select Save, inspect the preview, and Publish the product. Repeat for any other products that should link to this guide. Open a product as a visitor and follow the return link to confirm both directions. Guide links use compact cards; a guide can be useful without a cover image.
Keep references useful
References resolve the current published target. Changing a target's draft does not change its public card; publishing the new target version updates the displayed title, image or URL used by referencing pages.
If a target is unpublished or archived, its public link is hidden. Your saved selection remains available to repair. Use Refresh publication status, publish the correct target or remove the reference. An empty guide reference section is hidden from visitors; Clear product references and Clear guide references clear the respective selections without deleting the target content.
A product or guide from another site or language cannot be added as one of these references. Create appropriate content in the page's own language rather than using a reference as a substitute for a translation link.
Restore an archived guide
In the archived guide's Actions menu, choose Restore from Archive. The guide returns as a draft. Review the saved body, cover and references, then publish it when ready. Restoration alone does not make the guide public or restore its public links.
If publication reports that the draft changed elsewhere, keep any unsaved text and reload the editor to review the current saved draft. Publish only the version you have reviewed. If the conflict persists, contact support before making further changes.
Check the whole route
Test both a document and a blog article: guide → product → guide, followed by product → choose options → inquiry form. Submit fictional details and confirm the product and selected-option snapshot in Form submissions.
At phone width, check that tables scroll within their content area and that the whole page does not stretch sideways. Visitors should be able to read the guide and follow its ordinary product links even when JavaScript is unavailable. Do not treat a successful document test as proof that the blog path was also checked.