PHPackages                             sheadawson/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. [Utility &amp; Helpers](/categories/utility)
4. /
5. sheadawson/silverstripe-multisites

Abandoned → [silverstripe-australia/silverstripe-multisites](/?search=silverstripe-australia%2Fsilverstripe-multisites)Silverstripe-module[Utility &amp; Helpers](/categories/utility)

sheadawson/silverstripe-multisites
==================================

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

1.1.2(10y ago)01.8k1

Since Sep 11Pushed 2y agoCompare

[ Source](https://github.com/sheadawson/silverstripe-multisites)[ Packagist](https://packagist.org/packages/sheadawson/silverstripe-multisites)[ Docs](http://github.com/silverstripe-australia/silverstripe-multisites)[ RSS](/packages/sheadawson-silverstripe-multisites/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (4)Versions (13)Used By (0)

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

33

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~31 days

Recently: every ~25 days

Total

10

Last Release

3853d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6ca23b453a4fc5ac237ad4fcc512f68fab5c7b124f403cad1a5848b3fffb6aa2?d=identicon)[sheadawson](/maintainers/sheadawson)

---

Top Contributors

[![nyeholt](https://avatars.githubusercontent.com/u/161730?v=4)](https://github.com/nyeholt "nyeholt (53 commits)")[![sheadawson](https://avatars.githubusercontent.com/u/1166136?v=4)](https://github.com/sheadawson "sheadawson (28 commits)")[![drzax](https://avatars.githubusercontent.com/u/596563?v=4)](https://github.com/drzax "drzax (11 commits)")[![xini](https://avatars.githubusercontent.com/u/1152403?v=4)](https://github.com/xini "xini (3 commits)")[![silbinarywolf](https://avatars.githubusercontent.com/u/3859574?v=4)](https://github.com/silbinarywolf "silbinarywolf (3 commits)")[![r0nn1ef](https://avatars.githubusercontent.com/u/879793?v=4)](https://github.com/r0nn1ef "r0nn1ef (3 commits)")[![ajshort](https://avatars.githubusercontent.com/u/31570?v=4)](https://github.com/ajshort "ajshort (2 commits)")[![NikxDa](https://avatars.githubusercontent.com/u/3141005?v=4)](https://github.com/NikxDa "NikxDa (1 commits)")[![Neumes](https://avatars.githubusercontent.com/u/8358226?v=4)](https://github.com/Neumes "Neumes (1 commits)")[![JamesDPC](https://avatars.githubusercontent.com/u/69664712?v=4)](https://github.com/JamesDPC "JamesDPC (1 commits)")[![Iliain](https://avatars.githubusercontent.com/u/2579262?v=4)](https://github.com/Iliain "Iliain (1 commits)")[![Zauberfisch](https://avatars.githubusercontent.com/u/186158?v=4)](https://github.com/Zauberfisch "Zauberfisch (1 commits)")

---

Tags

silverstripesubsitesmultisites

### Embed Badge

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

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

###  Alternatives

[silverstripe/subsites

Run multiple sites from a single SilverStripe install.

65392.9k20](/packages/silverstripe-subsites)

PHPackages © 2026

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