Skip to main content

Overview

This guide is for site administrators -- the people who set up an OQO site, manage its appearance, organize content, and oversee contributors.

If you're a blogger who was invited to contribute, see the For Bloggers guide instead.

What You Manage​

As an admin, you control three areas:

AreaWhat It Covers
Page BuilderDesign your site using a visual editor with drag-and-drop sections, live preview, and an AI assistant that can build sections from a text description
ContentOrganize posts with tags, collections, and blogs. Review submissions from bloggers. Manage your media library.
AdministrationUser management, site settings, domains, billing, API keys, integrations

How the Platform Works​

┌──────────────────────────────────────────────────────────────┐
│                     Public Website                           │
│  Rendered by Liquid themes -- layouts, sections, settings    │
└──────────────────────────────────────────────────────────────┘
        ▲                                    ▲
        │ theme engine                       │ content
┌───────┴──────────┐              ┌──────────┴─────────┐
│   Admin Panel    │              │  Blogger Dashboard  │
│                  │  reviews     │                     │
│  Theme Editor    │◄─────────── │  Post Board          │
│  Page Builder    │  submissions │  Draft Editor        │
│  AI Designer     │             │  AI Review Feedback   │
│  Content Mgmt    │             │                      │
│  Settings        │             │                      │
└──────────────────┘              └─────────────────────┘

Admins and bloggers have completely separate dashboards. Bloggers never see the admin interface -- they have a focused authoring experience with only the tools they need to write and submit content.

When bloggers submit posts, an AI-powered review system evaluates quality, tone, and brand alignment. Most submissions are approved automatically. Edge cases are escalated to the admin review queue.

Core Concepts​

Themes​

A theme controls the visual design of your site. Each theme is a self-contained package with:

  • Layouts -- base HTML structure wrapping all pages (header, footer, zones)
  • Sections -- reusable, configurable page components (hero, content, CTA, navigation)
  • Snippets -- small reusable Liquid partials
  • Assets -- CSS, JavaScript, fonts, and images
  • Settings -- theme-wide configuration defined in a JSON schema

You customize a theme through the Theme Editor -- no code required. Theme developers build new themes using the OQO CLI.

Pages & Sections​

Pages are built by combining sections. Each section is a configurable component (hero banner, feature grid, call-to-action, navigation bar, footer, etc.) that you can add, remove, reorder, and customize in the visual editor.

Zone sections (header, footer, sidebar) are shared across all pages that use the same layout. Content sections are specific to each page.

Posts & the Review Workflow​

Posts are blog content created by your contributors (bloggers). The workflow:

  1. Blogger creates a draft using the element editor (rich text, images, galleries, video)
  2. Blogger submits for review
  3. AI reviewer evaluates quality, tone, and guideline adherence
  4. Post is approved automatically, sent back with revision feedback, or escalated to the admin queue

You configure review guidelines in Settings. The AI applies them consistently across all submissions.

Tags & Collections​

  • Tags -- flat labels for organizing posts (e.g., "technology", "culture", "events")
  • Collections -- smart or manual groupings of posts. Smart collections auto-populate based on rules (e.g., "all posts tagged 'technology' from the last 30 days"); manual collections are hand-curated.

Blogs​

Blogs are content channels. Each blog has its own post feed and URL. Bloggers assign their posts to a blog from the Post Board. You can have multiple blogs on a single site (e.g., "News", "Member Stories", "Events").

Next Steps​