Fast on ordinary hosting.

We put ShopClass 7.0 and Osclass 8.4 on the same server with the same 50 listings, and sent 10 visitors at once. ShopClass served more pages every second on every page we tried.

ShopClass 7.0.0Osclass 8.4.0Pages served per second, against Osclass (1×). More is better

Home page: 2.1×1×
Listing page: 1.6×1×
Search page: 2.2×1×

With the free nginx Cache plugin, the home page served 22 times as many pages as Osclass, which cannot use a page cache. Each page used 0.85 MB of PHP memory, against 1.0 MB for Osclass. See the full test

It runs a real site, too.

TuffClassified.com is a classifieds site in India with about 245,000 listings and 170,000 users. It runs on ShopClass. When crawlers started causing 502 errors there, we built the page cache that fixed it.

It also helps the project. Improvements we first made for that site move into core, and its real traffic helps us test new work.

Read how we did it

One engine, many kinds of site.

Each of these is the same ShopClass: listings with photos, categories, locations and search. You set the fields for each category in the admin, with no code. A few also need one free plugin from the market.

Classifieds
Buy-and-sell ads, the classic.
- Price
- Condition
- Photos
Job board
Vacancies by role and city, with jobs pulled in from partner feeds.
- Salary
- Job type
- Company
With the free Listing Import plugin
Property site
Homes and rooms to rent or buy.
- Rooms
- Rent or buy
- Area
Car site
Used and new vehicles.
- Make
- Model
- Year
- Mileage
Business directory
Local businesses, searchable by place and distance.
- Phone
- Opening hours
- Address
Rentals and bookings
Holiday homes, rooms or equipment, booked by date or time slot.
- Price per night
- Availability
- Deposit
With the free Booking Calendar plugin
Digital downloads
Templates, manuals and sample packs, sent through a private link.
- File type
- Version
- Licence
With the free Digital Goods plugin
Members-only board
A private community where visitors sign in before they see anything.
- Member type
- Area
- Photos
With the free Registered Users Only plugin

What a listings site needs, built in.

Every feature below ships with ShopClass under the same licence. None of them is a paid add-on.

Custom fields

Build a form for each category from reusable fields, with rules to show or hide them. Cars, homes or jobs, and no code needed.

Search & filters

Filter by region, city, price, keyword or photos, right next to the results, or find listings within a distance of a place. Every search has its own RSS feed, and sitemaps are made for you.

Spam & abuse tools

Turnstile or reCAPTCHA, a keyword blocklist, visitor reporting and login throttling. Throttling is on by default, and CAPTCHA turns on once you add your keys.

Comments & alerts

Threaded comments on a listing with optional moderation, and e-mail alerts when a saved search matches.

Credits & paid listings

Sell featured spots, bumps and extra photos for credits, and let a payment plugin take the money. It stays off until you want it, and a test gateway is included.

Page builder

Templates and a light editor for the pages around your listings: about, terms, help and landing pages.

Media library

One screen for every stored file, with search and bulk delete. Keep photos on your own server, or offload them to any S3-compatible storage behind a CDN.

Themes & plugins

A documented theme and plugin API, a package catalogue in the admin, and one-click updates for both.

CLI & Docker

Install, migrate and back up headlessly with oc-cli, or pull the published image and provision a whole site without opening a browser. The image runs background jobs itself, with Valkey, so it needs no cron line. It is there for developers. You do not need it to run a site.

Also in the box:Multi-languageLocations & regionsModeration queueSitemaps & RSSMaintenance modeBackupsCategory treePrivacy & data exportREST API & webhooksTwo-step admin sign-inRedis & Valkey cacheBackground jobs

Open to apps.

Since 7.0, ShopClass has a REST API and webhooks built in. They stay off until you switch them on in Settings → API.

Read and post. Mobile apps, scripts and other sites can read listings, and signed-in people can post, edit and comment.
Run the site with a key. An admin key manages listings, comments, users and settings. A moderator key reaches listings and comments only.
Webhooks. Other systems get a signed message when a listing, comment or user changes.

Switch on the API API guide Browse every endpoint

$ curl -H "Authorization: Bearer $KEY" \
  "https://your-site.example/api/v1/listings?q=bike&limit=1"

{
  "data": [{
    "id": 482,
    "title": "City bike, 54 cm frame",
    "price": {
      "amount": "120.00",
      "currency": "EUR",
      "formatted": "€120.00"
    },
    ...
  }],
  "meta": { "limit": 1, ... },
  "links": { "next": "..." }
}

Add more with free plugins and themes.

These come from the ShopClass market. You install them from the admin in one click, and they update the same way. This list refreshes every day.

Themes 3

StorefrontThe bundled default ShopClass theme since 6.0.0: a modern, responsive, vanilla-JS classifieds front end with automatic RTL and WCAG 2.1 AA contrast.FreeGPL-3.0+v2.1.0Live preview on the demo
FolioA typography-first ShopClass theme built on native HTML5 elements: one hand-written stylesheet, eight lines of JavaScript, no build step.FreeGPL-3.0+v0.5.0Live preview on the demo
GlanceA classifieds theme for comparing ads: read each ad in a side panel without losing your place in the list.FreeGPL-3.0+v1.0.1Live preview on the demo

Plugins 12

All plugins All themes Publish your own

7.0.2 latest stable

Released 21 October 2026

We release ShopClass regularly. Here is what the current release changed for people running a site.

All releases

A REST API for apps. Mobile apps, scripts and other sites can read listings, post and comment through /api/v1. It stays off until you switch it on in Settings.
Webhooks. Other systems get a signed message when a listing, comment or user changes.
Distance search. Visitors find listings within 5 to 100 km of a city or of where they are, and can sort nearest first.
Faster pages. More caching, kept database connections and compressed files. Redis and Valkey now work as the cache too.
Credits for sellers. A seller at the listing limit can buy an extra slot or an account upgrade with credits.
A tidier admin. The admin works on a phone, has short help text, and gets a media library for site images.

See it running.

These are real screenshots of the live demo, using the Shopfront theme that comes with ShopClass.

Search and filters next to the results.

Region, city, price, keyword and photo filters sit right next to the results, so people can narrow a search without leaving the page.

Faceted filters and price ranges
Grid or list, sortable results
Per-search RSS to subscribe

The ShopClass browse page: a filter sidebar beside a grid of for-sale listings with prices, photos and locations.

A listing page that answers questions.

Photos, price, location, the seller and the details for that category, all on one page. A buyer finds what they came to check without hunting for it.

Photo gallery with thumbnails
Per-category detail tables
Contact, share, report and comment

A ShopClass listing page: a photo gallery, price and location, a seller panel with a Message seller button, and a table of custom Electronics fields.

And the admin you run it from.

The operator's side of the same install. Log in with admin / admin and try it yourself: approve listings, change settings and set up the site.

The ShopClass admin dashboard: listing, user, comment and report tiles above a listings-by-category table, a statistics chart and a system-status panel. — Run it from one dashboard.
New listings, users, comments waiting for you and reported listings, above a status panel that shows your version, your PHP version and how much room your server has left.

The ShopClass forms builder: a Vehicle Details form of typed fields beside a panel of reusable fields such as Make, Model, Year and Fuel Type. — Set up any category, without code.
Create a field once, then drag it into the form for any category. This is the builder behind custom fields, above.

Open source since 2010.

ShopClass is not new code with an old name. It is Osclass, kept alive and rebuilt in the open. Every commit since the first one is still in its history.

2010 Osclass starts. The first commit lands in November.
2017 Mindstellar picks it up. Upstream releases stop at 3.7.4, so we fork it and keep fixing it.
2021 Osclass 5.0. PHP 8 support, a new installer and the move to GPLv3.
2026 ShopClass. The same project under its own name, now at 7.0.2.

The full story, for Osclass users

**Navjot Tomer**Maintainer, Mindstellar
Hi, I'm Navjot. I have looked after this code since 2017. The people below wrote parts of it, from small bug fixes to whole features. Thank you. If you find a bug or want something added, open an issue on GitHub.
@navjottomer on GitHub

37 people have code in ShopClass

Everyone on GitHub How to contribute

Open source is the whole point.

You can run it, read it, change it and share your changes. The GPLv3 licence gives everyone those four freedoms, for good.

Your data stays yours.

Listings, users and photos live in your own database and storage. Move or export them whenever you like, with no fees and no waiting.

Runs on cheap hosting.

Shared hosting and cPanel plans are enough. Move to a bigger server or Docker later, with the same files and the same database.

Change anything.

Read the code, fix a bug, add a field type or build a theme. Plugins, themes and the API are all documented.

Built in the open.

Report a problem, send a pull request or share a plugin. The GPLv3 licence keeps every improvement open for everyone.

Read the source on GitHub

Notes from running it.

What we learn running ShopClass on real sites, written up as guides. All posts

Get started.

Try the live demo first, then install it on your own host. It is free under the GPLv3.

The ShopClass guided web installer, first step: a green 'Your server meets every requirement' banner over a server checklist, with a Continue button. No terminal needed.

A guided installer in your browser.

Upload ShopClass to your host and open it in a browser. It checks your server, sets up the database and creates your admin login. You just click through. This is the real first screen you'll see.

Checks your host and flags anything missing
No config files to hand-edit
Generates a strong admin password

Poke at the live demo

It resets every hour, so explore freely: post a listing, open the admin, break things. admin / admin is waiting.

Open the demo

Put it on your own host

Download 7.0.2, upload it to any PHP 8.0+ host, and open it in your browser. The installer above does the rest.

Works on most shared and cPanel hosts.

Download ShopClass

Docker & the CLI

Prefer containers? Pull the published image and provision headlessly with oc-cli.

$ docker pull \
  ghcr.io/mindstellar/shopclass

Read the docs

ShopClass is classifieds software you run and own.