Content Pages

    contentPages

    Create and publish custom, block-based digital twin pages for your brand. This guide covers using content blocks, section styling, and AI tools to build rich mobile experiences.

    Content Pages — User Guide

    Welcome to Content Pages, the SmartLinks microapp that lets you build and publish rich content pages for your brand's digital twin experiences.


    Overview

    Content Pages is a block-based content management system built into the SmartLinks platform. You can create pages with headings, rich text, images, galleries, hero banners, call-to-action buttons, accordions, tables, timelines, and more — all without any coding.

    Pages you publish appear automatically in the SmartLinks portal alongside your products and proofs, giving customers useful information exactly when they need it.


    Getting Started

    First-Time Setup

    1. Open the Admin Panel — Navigate to your collection in the SmartLinks Admin Console and open the Content Pages app.
    2. Create Your First Page — Click New Page, give it a title and a slug (URL-friendly name like about-us or care-guide).
    3. Add Content Blocks — Use the block toolbar to add headings, text, images, and other content types.
    4. Publish — Set the page status to Published when you're ready for customers to see it.

    Configuration Settings

    In the Settings tab you can adjust:

    SettingDescription
    App TitleThe display name for your content pages app
    Default LanguageThe primary language for your content (default: English)
    NotificationsWhether to notify users when new content is published

    Creating Content

    Available Block Types

    BlockWhat It Does
    HeadingSection titles (H1, H2, H3) with styles: plain, underline, accent, gradient
    Rich TextFormatted paragraphs with bold, italic, links, and lists
    ImageSingle images with layout options: full-width, captioned, rounded, parallax
    HeroLarge banner sections with background image, title, subtitle, and CTA button
    GalleryMultiple images in grid, carousel, or masonry layout
    VideoEmbedded video from YouTube, Vimeo, or direct URL
    Feature Grid2–4 column grid of features with icons and descriptions
    Call-to-Action BannerHighlighted banner with button link
    AccordionExpandable FAQ-style sections
    CalloutHighlighted box for tips, warnings, or important information
    StatsNumeric statistics with labels
    QuoteStyled blockquote with attribution
    TableData tables with headers
    TabsTabbed content sections
    TimelineChronological events in vertical or alternating layout
    DividerVisual separator between sections
    SpacerAdjustable vertical spacing
    EmbedEmbed external content (iframes)
    WidgetEmbed another SmartLinks widget inline

    Section Styling

    Every block can have section-level styling applied:

    • Background — None, light, dark, accent, muted, gradient, custom colour, or background image/video
    • Padding — None, small, medium, large, extra-large
    • Text Colour — Auto (adapts to background), light, or dark
    • Animation — Fade in, slide up, slide left, zoom in, or none
    • Border — Optional top/bottom borders with solid, dashed, or dotted styles

    AI Content Assistant

    The admin panel includes an AI chat assistant that can help you:

    • Generate content — Describe what you want and the AI creates blocks for you
    • Generate images — Ask for images and review them before they're saved
    • Translate pages — Automatically translate content into other languages
    • Edit existing content — Ask the AI to rewrite, expand, or restructure your pages

    To use it, open the AI panel in the page editor and describe what you'd like.


    Multi-Language Support

    Content Pages supports multiple languages:

    1. Set your default language in Settings (typically English).
    2. Open a page in the editor.
    3. Switch language using the language panel.
    4. Translate — Edit translations manually or use the AI assistant to auto-translate.

    Translations are stored separately from the source content. Visitors see content in their preferred language automatically based on the ?lang= URL parameter.

    Supported languages: English, German, French (more can be added).


    Page Management

    Page Properties

    PropertyDescription
    TitleThe page's display title
    SlugURL-friendly identifier (e.g. care-guide) — used as ?pageId=care-guide
    Statusdraft or published — only published pages are visible to customers
    Show in ListingWhether the page appears in the page directory
    Deep LinkableWhether other apps and AI can discover and link to this page
    Page StyleOptional background and padding for the entire page

    Page Listing

    When no specific page is selected, customers see a directory of all published pages. If only one page is published, customers are taken directly to it.


    Embedding Content Pages

    Content Pages can be displayed in three ways:

    1. Iframe (Default)

    The standard SmartLinks portal embeds the app in an iframe. No extra setup needed.

    2. Container (SEO-Friendly)

    For platforms that need the content in the DOM (for SEO), use the ContentPageComponent container:

    CollectionId + AppId → loads all published pages
    CollectionId + AppId + PageId → loads a specific page
    

    The container inherits the parent platform's theme and renders directly in the page — no iframe.

    3. Widget

    A lightweight widget card can show a preview/summary. Widgets load immediately and are ideal for dashboards showing multiple apps.


    Deep Linking

    Published pages with Deep Linkable enabled are automatically registered so other SmartLinks apps, the portal navigation, and AI assistants can link directly to them.

    For example, if you publish a page with slug care-guide and enable deep linking, other apps can navigate to it using:

    { appId: 'content-pages', deepLink: 'care-guide' }
    

    FAQ & Troubleshooting

    Q: My page isn't showing up for customers. A: Check that the page status is set to Published and Show in Listing is enabled.

    Q: Images aren't loading. A: Ensure images were saved as assets (confirmed in the AI flow) rather than using temporary URLs.

    Q: Translations aren't appearing. A: Verify the translation exists for the target language and that the ?lang= parameter matches (e.g. de for German).

    Q: The page looks different in the portal vs the admin preview. A: The portal applies the brand's theme colours. Check that your section styles use theme tokens (accent, muted, etc.) rather than hard-coded colours.

    Q: How do I reorder blocks? A: Use the drag handles on the left side of each block in the editor, or use the up/down arrows in the block toolbar.

    Q: Can I duplicate a page? A: Not yet directly — but you can ask the AI assistant to "create a new page based on [existing page]" and it will copy the structure.