Skip to main content

 Version 5

Legacy documentation for PageSeeder v5

Servlet: ImportMembers



Imports members from comma-separated data.

HTTP method: GET

Returns data to produce the form for importing members.

HTTP method: POST

Actually import the members into PageSeeder.

Import data

The data uses comma-separated values as:

[firstname],[surname],[email],[username?],[password?],[field1?], ... ,[field15?]
  • If a value contains a comma, it should be wrapped by double quotes ".
  • It is not possible to include a line delimiter in a value, line delimiters are automatically interpreted as a separate member.
  • If the password is the encrypted form used in the PageSeeder database the encrypted password will be preserved. This is useful for migrating members to a different server but they must be exported using an SQL query.

To import the users into a group, use the group parameter. The membership details can be set using the notification, role and listed parameters.

Error handling

If a user already exists, the existing details are returned instead of the original details sent in the request. The details sent in the import data do NOT overwrite the existing data.

If the data is parsable, but the email or username is invalid, it is put as a failed user.

If a parsing error occurs, this method returns an error message with HTTP status 400 (Bad Request).

XML output

The returned XML is in the form:

  <group><!-- Group --></group>
  <totalread>[lines read]</totalread>
    <member><!-- Created Member #1 --></member>
    <member><!-- Created Member #2 --></member>
    <member><!-- Created Member #3 --></member>
    <memberdetails><!-- Failed Member #1 --></memberdetails>
    <memberdetails><!-- Failed Member #2 --></memberdetails>
    <memberdetails><!-- Failed Member #3 --></memberdetails>
    <memberdetails><!-- Existing Member #1 --></memberdetails>
    <memberdetails><!-- Existing Member #2 --></memberdetails>
    <memberdetails><!-- Existing Member #3 --></memberdetails>

HTTP parameters

dataThe data to import (required)yesString
groupThe name of the group the users should be imported intono String
notificationThe default notification for the users (applicable only if group is specified)no Stringimmediate 
roleThe default role for the users (applicable only if group is specified)norolegroup's default
listedWhether to list the email address of the imported users (applicable only if group is specified)no booleanfalse
createpersonalWhether to create a Personal group for the user on importnobooleanfalse


The notification parameter must be one of immediate, essential, daily, weekly or none. Users are able to change this setting at another time through the user interface in their group registration options.


The role parameter must be one of guest, reviewer, contributor, manager, approver.

Created on , last edited on