Welcome to Pebble Documentation

Pebble lets designers who code edit content without touching HTML structure.

Current Version: 1.0.0

This documentation covers Pebble v1.0.0, the latest stable release. See the changelog for version history.

What is Pebble?

Pebble lets you edit website content directly on your pages without touching HTML. You design the markup, Pebble manages the content.

Core Philosophy: "Your markup, your rules"

  • Edit content, not structure
  • Designers first - visual designers can use confidently
  • Stay lightweight - no bloat, essential features only
  • Self-hosted - you own your data

Quick Start

Get started with Pebble in 3 steps:

  1. Download the installer from hellopebble.io
  2. Upload install-pebble.php to your web server
  3. Run the installer by visiting it in your browser

Full installation guide: Installation →

Key Features

Individual Pebbles

Mark any HTML element as editable with a simple data-pebble attribute: 

<h1 data-pebble="page-title">Welcome to My Site</h1>
<p data-pebble="intro">Edit this text inline.</p>
<img src="logo.jpg" data-pebble="logo" data-pebble-type="image" />

Link Pebbles

Make links editable - users can change both the link text and URL: 

<a href="https://example.com"
   data-pebble="cta-button"
   data-pebble-type="link">Click Here</a>

Clicking a link pebble opens a modal to edit text and href. Great for CTAs, nav items, or any link that clients need to update.

Zones (Pro)

Rich text editing areas where users can add/edit/remove content blocks: 

<div data-pebble-zone="about-content"></div>

Users can freely edit paragraphs, headings, lists, and links within zones. Customize the toolbar with data-zone-toolbar.

Repeatable Pebbles

Template-constrained repetition for variable-quantity content: 

<div data-pebble-repeat="events"
     data-pebble-repeat-min="1"
     data-pebble-repeat-max="12">
  <div data-pebble-repeat-template>
    <h3 data-pebble="event-title">Event Name</h3>
    <p data-pebble="event-date">Date</p>
  </div>
</div>

Shared Content

Reuse content across multiple pages with data-pebble-shared="true": 

<p data-pebble="footer-text" data-pebble-shared="true">
  © 2025 Company Name
</p>

Edit once, update everywhere.

Why Pebble?

Feature Pebble WordPress Other CMSs
Bundle Size ~88KB ~2MB+ ~150-200KB
Your HTML Keep it Themes override Framework-dependent
Database None (flat files) MySQL required Usually required
Learning Curve Minimal Steep Moderate

Next Steps

New to Pebble? Start with the Installation Guide

Ready to use? Check out the Usage Guide

Need help? Visit Troubleshooting

Community & Support

Pebble is Free to Use

Pebble is free for personal and commercial projects. See our license for details.

License

Pebble is free to use for personal and commercial projects under a proprietary license.

You can use it on unlimited websites and modify the source code for your own projects.

Read the full License details →

Support

Need help with Pebble? Here are your options: