create new tag
, view all tags
ALERT! NOTE: This is a DistributionDocument. Please help maintain high quality documentation: This is a wiki, please fix the documentation if you find errors or incomplete content. Put questions and suggestions concerning the documentation of this topic in the comments section below. Use the Support web for problems you are having using TWiki.

Bulk Registration

Administrators can use this topic to register (i.e. create logins and user topics) for a group of people in one batch.

Unlike normal registration the administrator is assumed to have correct e-mail addresses for the users, so no verification is required. Note that the new users are not notified that they have an account. This is so you can prepare and verify the accounts before announcing them. To announce them use the BulkResetPassword feature: this will assign a new random password and notify users.

Bulk Registration usage

Note: this is an administrator job - only admistrators can run this.

If you are administrator, you will take these actions:

  1. (First time use) Create new bulk registration topics (see Settings below).
  2. In the REGISTERTOPIC topic: create a table of new users. An example table is provided below to copy.
  3. Return to this topic and press the button "Bulk Register" to create the new topics.
  4. Read UnprocessedRegistrationsLog to verify if all has gone well.
  5. When you are ready, use the BulkResetPassword page to assign passwords and notify the users of their new accounts.

Below are the details.


  • Define where to pick up the table of users to register
  • Use this to define where to log the bulk registration process. It needs to be a topic name in this web.
  • Set this to 1 to make the bulk registration overwrite any existing user topics. By default, existing user topics are left alone.

The user table

This table is a template for user data that will be written to the new user topics. If you stick to these basic fields you can just use the first example below. If you want to write more data (like phone number or country) read the section Customizing user data as well.

Example format

The following should be inserted into your UnprocessedRegistrations as a table. This is the most simple format:
| FirstName | LastName | Email | WikiName |
| Test | User | you@example.com | TestUser |


  1. Copy this text to your clipboard
  2. Click through and paste this on UnprocessedRegistrations.
  3. Add and customize entries, save table. Note that the first row must not contain bolded entries, so don't apply any formatting.
  4. Return here

Customizing user data

You can write additional data to the new user topics. Do this by enhancing the user table with additional field names as table headers.

Any fields you define in this table will end up in the User's topic. If a form (such as UserForm) is attached to NewUserTemplate then the data will go in as META:FIELDS, meaning that you can use SEARCH formfield constructs to search.

If you use the UserForm then ensure that it contains all the fields you define here. Otherwise they will disappear when the user edits their home topic!

Mandatory fields

  • WikiName
  • FirstName
  • LastName

Optional fields

Customized table example

Make sure that the extra fields also appear on the UserForm.
| FirstName | LastName | Email | WikiName | CustomFieldThis | SomeOtherRandomField | WhateverYouLike |
| Test | User | you@example.com | TestUser | A | B | C |



Registered Users


| Chad | Rigetti | chad@rigetti.com | CTR |
| Dane | Thompson | dane@rigetti.com | DCT |
| A | P | arjan.s.puniani@gmail.com| ASP_Test | </noautolink>

-- Rigetti Computing - 2014-11-13


Please use the Support forum if you have questions about TWiki features. This comment section is about the documentation of this topic.


Related Topics: AdminToolsCategory

Comments & Questions about this Distribution Document Topic

| Test | User | you@examplePLEASENOSPAM.com | TestUser | A | B | C |

When I try the above steps to bulk register, I get an error, "TWiki detected an internal error - please check your TWiki logs and webserver logs for more information.

Can't locate object method "new" via package "FileHandle" (perhaps you forgot to load "FileHandle"?)" The file /twiki/data/warn200605.txt has the below entry in the end:

| 29 May 2006 - 20:36 | Can't locate object method "new" via package "FileHandle " (perhaps you forgot to load "FileHandle"?) at /twiki/lib/TWiki/Data/DelimitedF ile.pm line 36. TWiki::Data::DelimitedFile::read('content','','delimiter','|') called at /twiki/lib/TWiki/UI/Register.pm line 215 TWiki::UI::Register::bulkRegister('TWiki=HASH(0x87ee640)') called at /tw iki/lib/TWiki/UI/Manage.pm line 59 TWiki::UI::Manage::manage('TWiki=HASH(0x87ee640)') called at /twiki/lib/ TWiki/UI.pm line 97 TWiki::UI::__ANON__() called at /twiki/lib/CPAN/lib///Error.pm line 387 eval {...} called at /twiki/lib/CPAN/lib///Error.pm line 379 Error::subs::try('CODE(0x8a1df94)','HASH(0x8a1e258)') called at /twiki/l ib/TWiki/UI.pm line 146 TWiki::UI::run('CODE(0x81d9cd8)') called

-- RaghuSarangapani - 29 May 2006

Please ask support questions in the Support web.

-- PeterThoeny - 29 May 2006

Hi, when I click the button-press "Bulk Register these people", then I get the following error message " Insecure dependency in open while running with -T switch at .lib/TWiki/Store/RcsFile.pm linie793" can someone tell what to do? thanks for help.

-- SipanArarat - 2011-10-14

That sounds like a bug. Could you file a report at TWikibug:WebHome? Specify the TWiki version and server OS used.

-- PeterThoeny - 2011-10-14

Hi, Version: TWiki 5.0.1 Server Os : Debian

-- SipanArarat - 2011-10-17

Please use the Support forum if you have questions about TWiki features. This comment section is about the documentation of this topic.
Edit | Attach | Watch | Print version | History: r9 < r8 < r7 < r6 < r5 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r9 - 2011-10-17 - SipanArarat
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2016 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.