Managing Webs

What are Webs?

A Foswiki site is divided into "Webs", or groups or topics - each one represents one subject, one area of collaboration. Administrators can add, rename or delete webs.
At file level, a Web is a directory located inside the data directory, with text files as topics.
A number of Webs are fixed: System for documentation, Main to store user pages and site-wide preferences, Trash for the topic recycle bin.
Other webs can be created as needed.

Webs on this site

  • Welcome to C2SM Wiki... Users, Groups
  • Used to: ...see who is registered on this site
  • Home of Main web Search Main web Recent changes in the Main web Get notified of changes to the Main web
  • Welcome, Registration, and other System.StartingPoints; Foswiki history & Wiki style; All the docs...
  • Used to: Foswiki details, and how to start your own site.
  • Home of System web Search System web Recent changes in the System web Get notified of changes to the System web
  • COSMO Web
  • Used to:
  • Home of COSMO web Search COSMO web Recent changes in the COSMO web Get notified of changes to the COSMO web
  • Used to:
  • Home of Data web Search Data web Recent changes in the Data web Get notified of changes to the Data web
  • Data Management
  • Used to:
  • Home of DataManagement web Search DataManagement web Recent changes in the DataManagement web Get notified of changes to the DataManagement web
  • COSMO Web
  • Used to:
  • Home of GCM web Search GCM web Recent changes in the GCM web Get notified of changes to the GCM web
  • COSMO Web
  • Used to:
  • Home of ICON web Search ICON web Recent changes in the ICON web Get notified of changes to the ICON web
  • LS3MIP for Sonia Seneviratne
  • Used to:
  • Home of LS3MIP web Search LS3MIP web Recent changes in the LS3MIP web Get notified of changes to the LS3MIP web
  • Sandbox test area with all features enabled.
  • Used to: ...experiment in an unrestricted hands-on web.
  • Home of Sandbox web Search Sandbox web Recent changes in the Sandbox web Get notified of changes to the Sandbox web

This table is updated automatically based on WebPreferences settings of the individual webs. Topic home: System.SiteMap.

home Go to the home of the web
recentchanges See recent changes in the web
searchtopic Search the web
notify Subscribe to get notified of changes by e-mail

Create a new web

To use this form you must be administrator.

Before you begin: consider that less webs are better than more webs. Cross-linking topics is easier, and searches are faster, if there are only a few larger webs.

Name of the new Web Required

Naming rule: the name must start with an upper case letter, followed by upper or lower case letters or numbers. Examples: Learn, SupDocs, KNow3

If you are creating a nested web (a web inside a web), use the notation Existingweb.Newweb.
+ More info about nested webs ...− Close info

About hierarchical webs

You can only create hierarchical webs if the {EnableHierarchicalWebs} setting in configure is enabled. Hierarchical webs are currently enabled .

You might not need hierarchical webs. Foswiki topics already have a parent/child relationship within a web, which is shown in the breadcrumb. Try to keep the number of webs to a minimum in order to keep search and cross-referencing simple.


Enter a short description of the web. This description will be used in the SiteMap. If you are using links: write Web.TopicName instead of just TopicName for correct linking.

+ Show additional settings...− Hide additional settings

Template web

Base the new web on an existing web.
+ More info about template webs ...− Close info

About template webs

There are two methods used to create a new web.
First you can use a specially designed TemplateWeb. This is an invisible web that begins with an underscore "_" character (for example _default). All topics in the template web will be copied into your new web.
The second method is to use an existing web as a template web. This may be useful if you already have a web that you would like to use as a starting point. Only topics that have names beginning with "Web..." (like "WebHome" or "WebNotify") are copied. In either case you will want to be sure to verify that your new web has all the custom modifications that you desire.


  • You must have ROOTCHANGE access to create a top-level web (one with no parent)
  • A new web created using the _default or _empty template webs must have their access controls set before public use
  • Only the person who created it has permission to change the WebPreferences in the new web

List on SiteMap page

Should the new web be listed on SiteMap (see #SiteMap above)? Even if hidden, the web will be linkable and accessible to users.

Include in global search

Specify if you want to exclude the web from a global search.

Web color

Displayed on SiteMap and in the left bar (Pattern Skin).

In-depth info on Webs

Subweb preferences are inherited

The preference settings of a subweb are inherited from the parent web and overridden locally. Preferences are ultimately inherited from the System.DefaultPreferences topic.

Example Preference Inheritance for Sandbox/TestWeb/SubWeb.SubWebTopic topic:

  1. System.DefaultPreferences default settings
  2. Main.SitePreferences site-wide settings inherits from and overrides settings in System.DefaultPreferences
  3. Sandbox.WebPreferences inherits from and overrides settings in Main.SitePreferences
  4. Sandbox/TestWeb.WebPreferences inherits from and overrides settings in Sandbox.WebPreferences
  5. Sandbox/TestWeb/SubWeb.WebPreferences inherits from and overrides settings in Sandbox/TestWeb.WebPreferences
  6. Sandbox/TestWeb/SubWeb.SubWebTopic inherits from and overrides settings in Sandbox/TestWeb/SubWeb.WebPreferences

Subweb navigation

The Pattern skin (default) indicates Subwebs by indenting them in the sidebar relative to their level in the hierarchy.

Renaming or Deleting a Web

Rename a web via the Tools section in each WebPreferences topic. You may delete a web by moving it into a Trash web.


You may only rename a web if you have the following permissions

Renaming the webs in the distribution

It is possible, though not recommended, to change the names of the webs in the distribution. If you plan to rename the Main web, remember that Foswiki stores user topics in this web. That means that every WikiName signature - Main.SomeUserName - points to it and would need updating (unless the macro style %USERSWEB%.SomeUserName, is used throughout). This potentially large change can be performed automatically if you rename the web from the Tools section of WebPreferences, as described above.

ALERT! If you want to rename the System or Main webs, remember they are referred to in the Foswiki configuration. You will need to change the {SystemWebName}, {UsersWebName} and/or {LocalSitePreferences} settings in the configuration using the configure interface.

ALERT! Renaming the webs in the distribution is not recommended because it makes upgrades much more complicated.

Related Topics: AdminDocumentationCategory, AdminToolsCategory spacer