ShopClass is classifieds software you run and own.
ShopClass is open-source classifieds software you run on your own hosting. The same engine runs job boards, property and car sites, and directories. There are no per‑listing fees and no hosted service in between, and you can move your site whenever you like.
The demo is live and resets every hour. admin / admin opens the admin, so go ahead and try it.
- 6.4.6 latest
- GPLv3
- PHP 8.0+
- Docker image
Fast on ordinary hosting.
We put ShopClass 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.
- Home page
- Listing page
- Search page
With the free nginx Cache plugin, the home page reached 7,584 pages a second. Each page used 0.8 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 itOne 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.
Classifieds
Buy-and-sell ads, the classic.
- Price
- Condition
- Photos
Job board
Vacancies by role and city.
- Salary
- Job type
- Company
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.
- Phone
- Opening hours
- Address
Services site
Plumbers, tutors, cleaners and the like.
- Service
- Area covered
- Rate
Events or rentals
Show what is on or for hire. There is no booking, so visitors contact you.
- Date
- Venue
- Price
Product catalogue
Show products; buyers contact the seller.
- Brand
- Price
- Stock
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. 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
Keep listing 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, back up and run cron headlessly with oc-cli, or pull the published image and provision a whole site without opening a browser. 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 export
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.
FolioA typography-first ShopClass theme built on native HTML5 elements: one hand-written stylesheet, eight lines of JavaScript, no build step.
GlanceA classifieds theme for comparing ads: read each ad in a side panel without losing your place in the list.
CloudflareIntegrationsPurge Cloudflare's cache when listings change, install the recommended cache rules, and view cache analytics.
nginx CacheAdmin toolsHold pages in nginx's FastCGI cache for an hour instead of thirty seconds, and purge them the moment a listing changes.
Digital GoodsListings & moderationLet sellers attach downloadable files to a listing, stored privately and served through a gated link.
Registered Users OnlyAdmin toolsRequire a visitor to sign in before they can see the site, with control over what stays public.
QR CodeContent & widgetsShow a QR code for a listing so it can be scanned, shared or printed.
Required Registration FieldsAdmin toolsAsk for more than a name and an email when someone registers, and require the fields you pick.
Age WarningAdmin toolsShow an age-confirmation notice before a visitor sees adult content, and remember the answer.
Google AnalyticsAdmin toolsAdd Google Analytics 4 to your site, with consent gating and a per-browser opt-out.
Listing ImportAdmin toolsImport listings from other systems through the site's REST API or scheduled JSON, CSV and RSS feeds.
Stripe PaymentPaymentsTake card payments for credit packages through Stripe Checkout, with signed webhooks and refunds from the admin.
6.4.6 latest stable
Released 10 October 2026
We release ShopClass regularly. Here is what the current release changed for people running a site.
All releases- Two-step sign-in for admins. Add a code from an authenticator app on your phone, with backup codes in case you lose it.
- Security updates can install themselves. Switch it on and ShopClass installs security releases by itself, then e-mails you how it went.
- Backup and restore, built in. Back up the database, the files or both from Tools, or from the command line, and restore in the background.
- Receipts and refunds. Buyers get a receipt by e-mail, and a paid order can be refunded from its order screen when the payment plugin supports it.
- Smaller photos. Save photos as WebP, about a third smaller. Large phone photos shrink before upload, and iPhone HEIC photos are accepted.
- Faster pages. Listing pages read every card's badges in one query, and slow work like cleanup runs in a background job queue.
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
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
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.
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.
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.
Written since 2010, by people you can look up.
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.
- Osclass starts. The first commit lands in November.
- Mindstellar picks it up. Upstream releases stop at 3.7.4, so we fork it and keep fixing it.
- Osclass 5.0. PHP 8 support, a new installer and the move to GPLv3.
- ShopClass. The same project under its own name, now at 6.4.6.
Has worked on this code since 2017 and wrote 3,046 of its commits. Issues and pull requests on GitHub reach him directly.
@navjottomer on GitHub
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.
Notes from running it.
What we learn running ShopClass on real sites, written up as guides. All posts
Why we built our own places dataset, and gave it away
ShopClass needed countries, states and cities it could ship with no strings attached. Nothing fit, so we built one from Wikidata and released it as CC0.
Zero-downtime ShopClass deploys: blue-green with an nginx edge
Upgrade a Docker Compose ShopClass site without a single 502. Two app containers, an nginx edge that flips between them, and an instant rollback.
Get started.
Try the live demo first, then install it on your own host. It is free under the GPLv3.
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.
Put it on your own host
Download 6.4.6, 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 ShopClassDocker & the CLI
Prefer containers? Pull the published image and provision headlessly with oc-cli.
$ docker pull \ ghcr.io/mindstellar/shopclassRead the docs