Change List Short Name

Plugin: change_list_shortname.cgi - Change your mailing list's Short Name

Your mailing list's, Short Name is what Dada Mail uses as a unique identifier internally to tell your mailing list apart from every other mailing list. This Short Name is picked out, when you create your mailing list. Although used internally, you may also see it in the various query strings Dada Mail sets for navigation and email confirmations.

Because of this public view, or an otherwise internal name, you may want to change the List Short Name. Perhaps you picked out a really bad Short Name like, temporarytest or listthree and you've found that your mailing list isn't so temporary, or it's the only mailing list you have, instead of being in a series.

This plugin allows you to change your List Short Name


There's some major caveats when using this plugin, that you want to be aware of, before using it to change your List Short Name

SQL backend-only

This plugin only works if you are using one of the SQL backends: MySQL, PostgreSQL, or SQLite. It will not work with the Default backend.

Always make a backup of your complete database

We encourage you to make a backup of your complete SQL database, before using this plugin. Although checks are made to verify there won't be any problems with using a new List Short Name for a current mailing list, we still want you to err on the side of caution.

Text Logs are not processed

This plugin works by changing the List Short Name found in the various tables in your SQL database that makes up your Dada Mail Mailing Lists. Text Logs, such as your error log or usage log are not touched.

Any current static Subscription forms, and any subscription/unsubscription links embedded in already sent email messages will most likely break, once you've changed your List Short Name. You will potentially need to update the Subscription forms located on your website, but there's nothing you can do with the links in any sent email messages.


This plugin can be installed during a Dada Mail install/upgrade, using the included installer that comes with Dada Mail. The below installation instructions go through how to install the plugin manually.

Change permissions of "change_list_shortname.cgi" to 755

The, change_list_shortname.cgi plugin will be located in your, dada/plugins diretory. Change the script to, 755

Configure your .dada_config file

Now, edit your .dada_config file, so that it shows the plugin in the left-hand menu, under the, Plugins heading:

First, see if the following lines are present in your .dada_config file:

 # start cut for list control panel menu

 # end cut for list control panel menu

If they are, remove them.

Then, find these lines:

 #                                      {
 #                                      -Title      => 'Change Your List Short Name',
 #                                      -Title_URL  => $S_PROGRAM_URL."/plugins/change_list_shortname.cgi",
 #                                      -Function   => 'change_list_shortname',
 #                                      -Activated  => 0,
 #                                      },

Uncomment the lines, by taking off the, "#"'s:

                                        -Title      => 'Change Your List Short Name',
                                        -Title_URL  => $S_PROGRAM_URL."/plugins/change_list_shortname.cgi",
                                        -Function   => 'change_list_shortname',
                                        -Activated  => 0,

Save your .dada_config file.

You can now log into Control Panel Settings (make sure to log in with the Dada Mail Root Password) and under the, plugins heading you should now see a linked entitled, "Change Your List Short Name". Clicking that link will bring you to this plugin.


Copyright (c) 1999 - 2016

Justin Simoni

All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

Dada Mail Project