Application Configuration

plone.server handles configuration application customizations and extension mostly with decorators in code.

This page is meant to be a reference to the available decorators and options to those decorators.



  • context: Content type interface this service is registered against. Example: ISite: required
  • method: HTTP method this service works against. Default is GET
  • permission: Permission this service requires. Default is configure default_permission setting
  • layer: Layer this service is registered for. Default is IDefaultLayer
  • name: This is used as part of the uri. Example @foobar -> /mycontent/@foobar. Leave empty to be used for base uri of content -> /mycontent.

content type


  • portal_type: Name of the content type: required
  • schema: Interface schema to use for type: required
  • add_permission: Permission required to add content. Defaults to plone.AddContent
  • allowed_types: List of types allowed to be added inside this content assuming it is a Folder type. Defaults to allowing all types.



  • title: Name of behavior
  • provides: Interface this behavior provides
  • marker: Marker interface to apply to utilized instance’s behavior
  • for_: Content type this behavior is available for



  • name: required
  • title: required



  • for_: Type or list of types this adapter adapts: required
  • provides: Interface this adapter provides: required
  • name: Your adapter can be named to be looked up by name
  • factory: To use without decorator syntax, this allows you to register adapter of class defined elsewhere



  • for_: Type or list of types this subscriber is for: required
  • handler: A callable object that handles event, this allows you to register subscriber handler defined elsewhere
  • factory: A factory used to create the subscriber instance
  • provides: Interface this adapter provides–must be used along with factory



  • provides: Interface this utility provides
  • name: Name of utility
  • factory: A factory used to create the subscriber instance



  • id
  • title
  • description



  • id
  • title
  • description



  • role: ID of role
  • principal: ID of principal to grant to
  • permission: ID of permission to grant
  • permissions: List of permission IDs to grant to



  • principal: ID of principal
  • role: ID of role