Skip to Content
Pindown.ai is in early alpha - features may change
Platform GuideCreating a Page

Creating Your First Page

A page is a structured document where you organize pins in a linear flow. Perfect for reports, documentation, articles, or any content that needs a sequential layout.

What Are Pages?

Pages are collections of pins organized from top to bottom:

  • ✅ Linear flow: Content reads naturally from top to bottom
  • ✅ Multiple pins: Add as many pins as you need
  • ✅ Structured: Perfect for reports, documentation, articles
  • ✅ Shareable: Share pages publicly or with collaborators

Pages vs Pinboards:

  • Pages: Linear, document-style layout (like a blog post or report)
  • Pinboards: Visual dashboard with drag-and-drop grid layout

Step-by-Step Guide

1. Navigate to Pages

  1. Log in to your Pindown.ai account
  2. Click on “Pages” in the left sidebar
  3. You’ll see all your existing pages (if any)

2. Create New Page

Click the “Create Page” button (or ”+ New” in the top right).

3. Configure Your Page

Fill in the details:

Name (Required)
Give your page a descriptive name

  • ✅ “Monthly Sales Report”
  • ✅ “Product Launch Documentation”
  • ❌ “Page 1”

Tags (Optional)
Add tags to organize and filter your pages

  • report, sales, monthly
  • documentation, product, guide

4. Save and Open

Click “Create Page” and you’ll be taken to your new empty page!

Adding Pins to Your Page

Once you’ve created a page, you’ll see a 2-column layout:

  • Left column: Search and browse your available pins
  • Right column: Preview of pins currently on your page

Method 1: Create New Pin

  1. In the left column, click the “Add Pin” button
  2. A modal opens - choose pin type (Stat Card, Markdown, Chart, etc.)
  3. Fill in the configuration
  4. Click “Create” - the pin is automatically added to your page!

Method 2: Add Existing Pin

  1. In the left column, you’ll see a list of your available pins (pins not yet on this page)
  2. Use the search box to find specific pins
  3. Click the ”+” button next to any pin
  4. The pin is immediately added to your page (appears in the right column)

Method 3: Via API (Automated)

You can also create pins and add them to pages programmatically:

import { PindownClient } from '@pindownai/client-js'
 
const client = new PindownClient({
  apiKey: process.env.PINDOWN_API_KEY
})
 
// Create a page
const page = await client.pages.create({
  metadata: {
    title: 'Monthly Sales Report',
    tags: ['sales', 'monthly', 'report']
  }
})
 
// Add a pin to the page
await client.pages.addPin(page.id, {
  pin_id: 'p-abc123' // Your pin ID
})
 
console.log(`Page created: ${page.id}`)

Page Structure

Pages display pins in a linear, top-to-bottom flow:

┌─────────────────────────┐
│  Page Title             │
├─────────────────────────┤
│  Pin 1: Header         │
│  (Markdown)             │
├─────────────────────────┤
│  Pin 2: Stats           │
│  (Stat Cards)           │
├─────────────────────────┤
│  Pin 3: Chart           │
│  (Line Chart)           │
├─────────────────────────┤
│  Pin 4: Analysis        │
│  (Markdown)             │
└─────────────────────────┘

Each pin appears in the order you add it, creating a natural reading flow.

Example: Monthly Report Page

Here’s how to build a complete monthly report:

Step 1: Create the Page

{
  "metadata": {
    "title": "November 2024 Sales Report",
    "tags": ["sales", "monthly", "report"]
  }
}

Step 2: Add Header Pin (Markdown)

{
  "pin_type": "markdown",
  "pin_config": {
    "content": "# November 2024 Sales Report\n\n## Executive Summary\n\nThis month showed strong growth..."
  }
}

Step 3: Add Stats Pin

{
  "pin_type": "stat-cards",
  "pin_config": {
    "cards": [
      {
        "title": "Total Revenue",
        "value": "$145,230",
        "change": "+23.5%"
      },
      {
        "title": "Orders",
        "value": "1,450"
      }
    ]
  }
}

Step 4: Add Chart Pin

{
  "pin_type": "line-chart",
  "pin_config": {
    "title": "Sales Over Time",
    "data": [
      { "date": "2024-01-01", "value": 1200 },
      { "date": "2024-01-02", "value": 1450 },
      { "date": "2024-01-03", "value": 1680 }
    ]
  }
}

Step 5: Add Analysis Pin (Markdown)

{
  "pin_type": "markdown",
  "pin_config": {
    "content": "## Analysis\n\nKey insights and trends..."
  }
}

Pin Order

Pins appear on your page in the order you add them (top to bottom). The first pin you add appears at the top, and subsequent pins appear below it.

Note: Drag-and-drop reordering is coming soon!

Best Practices

1. Start with a Header

Always begin your page with a markdown pin that includes:

  • Page title
  • Table of contents (optional)

2. Use Logical Flow

Organize pins in a logical sequence:

  • Introduction → Overview, context
  • Data → Stats, charts, metrics
  • Analysis → Insights, interpretation
  • Conclusion → Summary, next steps

3. Mix Pin Types

Combine different pin types for variety:

  • Markdown for text content
  • Stat cards for key metrics
  • Charts for visualizations
  • Tables for detailed data

5. Keep It Focused

Each page should have a clear purpose:

  • ✅ “Q4 Sales Report”
  • ✅ “Product Launch Guide”
  • ❌ “Everything About Our Company”

Sharing Your Page

Share Publicly

  1. Open your page
  2. Click “Share” button
  3. Toggle “Make public”
  4. Copy the share link
  5. Anyone with the link can view!

Invite Collaborators

  1. Click “Share” button
  2. Enter email address
  3. Choose role:
    • Viewer: Can only view
    • Editor: Can edit pins and content
  4. Send invite

Pages vs Pinboards

Use Pages when:

  • ✅ You need a linear, document-style layout
  • ✅ Content should flow from top to bottom
  • ✅ You’re creating reports or documentation
  • ✅ You want a reading experience

Use Pinboards when:

  • ✅ You need a visual dashboard
  • ✅ You want drag-and-drop layout
  • ✅ You’re building analytics dashboards
  • ✅ You need grid-based organization

Next Steps

Need Help?

OverviewCreate a Pinboard