PHPackages                             symbiote/silverstripe-multisites - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. symbiote/silverstripe-multisites

ActiveSilverstripe-vendormodule[Framework](/categories/framework)

symbiote/silverstripe-multisites
================================

Allows for multiple websites to be managed through a single site tree.

5.2.6(5y ago)1313.7k33[1 issues](https://github.com/symbiote/silverstripe-multisites/issues)[1 PRs](https://github.com/symbiote/silverstripe-multisites/pulls)4PHP

Since Sep 11Pushed 4y ago4 watchersCompare

[ Source](https://github.com/symbiote/silverstripe-multisites)[ Packagist](https://packagist.org/packages/symbiote/silverstripe-multisites)[ Docs](http://github.com/symbiote/silverstripe-multisites)[ RSS](/packages/symbiote-silverstripe-multisites/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (10)Dependencies (4)Versions (56)Used By (4)

SilverStripe Multisites
=======================

[](#silverstripe-multisites)

[![Build Status](https://camo.githubusercontent.com/4f36cf6078dae77479dd375d0aa3163752ed9baaf986c9c8a9ccac1da7f4c603/68747470733a2f2f7472617669732d63692e6f72672f73796d62696f74652f73696c7665727374726970652d6d756c746973697465732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/symbiote/silverstripe-multisites)

Overview
--------

[](#overview)

Allows for multiple websites to be managed through a single site tree.

This is an alternative module to the Subsites module; it avoids any session tracking of the 'current' website, and doesn't perform any query modification at runtime to change the 'site' context of queries you execute

**Compatible with SilverStripe 4.0.x**

- Please see 4.0.x for 3.5 compatibility
- Please see the 1.2.x version for 3.1 compatibility

Upgrading to SS4
----------------

[](#upgrading-to-ss4)

The following important changes have happened

- Themes must now be explicitly configured in your project config. Set `Site.available_themes` in yml config. This must be a map of themename: Label
- Site specific Assets folders are not currently supported due to the fundamental change to asset management. This will be reviewed over time

Requirements
------------

[](#requirements)

- SilverStripe 4.\*
- [MultivalueField](https://github.com/nyeholt/silverstripe-multivaluefield)

Installation
------------

[](#installation)

- Add the module and the multivaluefield module
- Run `dev/build`

Setting up sites (and additional sites)
---------------------------------------

[](#setting-up-sites-and-additional-sites)

- In the CMS go to the Pages section and click on the Website
- Enter in the full path to the site in the 'Host' field, without the `http://`lead - eg `mysitedomain.com` or `localhost/sub/folder` for a development site
- Hit save
- To add a new site, click the Pages section; you should have an 'Add site' button
- Enter details about the new site, the Host field being the most important

Configuration
-------------

[](#configuration)

```
Site:
  available_themes:
    name: Label

```

To support cascading themes, provide a comma-separated list of themes for 'name' in configuration.

Assets management
-----------------

[](#assets-management)

NOTE: This is currently NOT working in SS4 due to the change to the asset management layer. Once clearer, this will be re-enabled.

You can optionally manage each site's assets in it's own subfolder of the root assets/ directory. Add the following extensions in your mysite/config.yml file and run ?flush=1. When editing a Site in the CMS, you now have the option to select a subfolder of assets/ to contain all assets for that site. This folder will be automatically created upon a) saving the site or b) visiting a page in the cms that has an upload field.

```
FileField:
  extensions:
    - MultisitesFileFieldExtension

HtmlEditorField_Toolbar:
  extensions:
    - MultisitesHtmlEditorField_ToolbarExtension
```

Files uploaded through the HTMLEditor will now be uploaded into assets/yoursite/Uploads. If you have custom upload fields in the cms however, you will need to add the following configuration to them explicitly.

```
$fields->fieldByName('Root.Main.Image')->setFolderName('images/page-images')->useMultisitesFolder();
```

The above call to useMultisitesFolder() will change the folder name from ' images/page-images' to 'currentsitesubfolder/images/page-images'

Known issues
------------

[](#known-issues)

When linking to a page that belongs to a different site, SiteTree::Link() will return a bad link as it prepends the base URL. Currently the best way to work around this is to implement the following in your Page.php (model class).

```
/**
 * Overrides SiteTree->Link. Adds a check for cases where we are linking to a
   page on a
 * different site in this multisites instance.
 * @return String
 **/
public function Link($action = null) {
	if($this->SiteID && $this->SiteID == Multisites::inst()->getCurrentSiteId()) {
		return parent::Link($action);
	} else {
		return $this->RelativeLink($action);
	}
}
```

- See [GitHub](https://github.com/symbiote/silverstripe-multisites/issues?state=open)

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity33

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity77

Established project with proven stability

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~43 days

Recently: every ~54 days

Total

50

Last Release

2032d ago

Major Versions

1.2.x-dev → 2.0.42016-12-14

2.0.x-dev → 3.0.02017-03-09

3.0.1 → 4.0.02017-06-23

4.2.0 → 5.0.02017-11-10

4.3.0 → 5.0.12018-01-24

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/23506857?v=4)[Symbiote](/maintainers/symbiote)[@symbiote](https://github.com/symbiote)

---

Tags

silverstripesubsitesmultisites

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/symbiote-silverstripe-multisites/health.svg)

```
[![Health](https://phpackages.com/badges/symbiote-silverstripe-multisites/health.svg)](https://phpackages.com/packages/symbiote-silverstripe-multisites)
```

###  Alternatives

[composer/installers

A multi-framework Composer library installer

1.4k136.0M6.0k](/packages/composer-installers)[silverstripe/cms

The SilverStripe Content Management System

5163.4M1.3k](/packages/silverstripe-cms)[dnadesign/silverstripe-elemental

Elemental pagetype and collection of Elements

1151.0M255](/packages/dnadesign-silverstripe-elemental)[silverstripe/subsites

Run multiple sites from a single SilverStripe install.

65392.9k20](/packages/silverstripe-subsites)[cwp/cwp

CWP features module. We strongly recommend using it for all new sites. Future features will be delivered here.

11221.1k6](/packages/cwp-cwp)[swipestripe/swipestripe

Ecommerce module to create online shops using SilverStripe.

336.4k9](/packages/swipestripe-swipestripe)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)