Close (X)

Blog

Email Marketing, Business & Monkeys

Table of Contents Merge Tag

July 15th, 2009 | by Amanda

MC:TOC1In the latest MailChimp upgrade we developed an easy way for you to add a table of contents to your newsletter.

The * | MC:TOC | *  dynamic merge tag works by pulling anything from your email that is formatted as Title text, and displaying it as an ordered list complete with bullet points. Each item in your table of contents is then anchor linked to the corresponding blurb in your email.

To add a table of contents to your email, simply insert * | MC:TOC | * where you’d like the contents listing to appear. In the example screen shots you can see that I added some Title text (”In this edition of The MonkeyWrench”), and then added the merge tag below it.

TOCmergeTITLE

MC:TOC2

You can also insert a Table of Contents in either the right or left column of a two-column template and the merge tag will work exactly the same way.

(I’ve used extra spaces between the elements of the merge tag so that it will render correctly for those who subscribe to the RSS-to-Email version of the blog.)

Spread the monkey love:
  • TwitThis
  • Digg
  • Facebook
  • del.icio.us
  • Reddit
  • StumbleUpon
  • description
  • Google
  • LinkedIn
  • Ma.gnolia
  • MisterWong
  • Netvouz
  • NewsVine
  • Slashdot
  • Technorati
  • YahooMyWeb
  • BlinkList
  • Design Float
  • Mixx
  • Pownce
  • Propeller
  • Webnews.de

17 Comments

    • Russell James says:

      I read somewhere that you were going to be offering some nice template designs. When is that planned for? :-)

      • Ben Sclair says:

        Hey Russell,

        Remove the spaces from * | MC:TOC | * to look like this *|MC:TOC|*, then it works.

        I got the same thing when I first inserted to code. Works perfectly now. Thanks MailChimp. Eep.

    • Josh Hutchinson says:

      This is great, I look forward to using this (much easier than trying to update my TOC each week based on what I (fairly capriciously) decide to include.

      However, it only seems to work in a side column for me if I also have the tag in the main column as well — otherwise it seems to just render as blank.

      • Amanda says:

        We found a small bug, but everything should be working as expected now.

        • Tammy says:

          how do i customize the emails? for example i want to insert their first name in the greeting and maybe their mypage in another paragraph…

          thanks
          tammy

          • Ben says:

            Hi Tammy,

            You’d use what we call “merge tags.” When you import a database of subscribers (such as from an Excel spreadsheet), each column of data gets its own merge tag. For example, “First name” might be *|FNAME|*

            If you import a spreadsheet with lots of custom fields, like “mypage” or “customerID” then you can specify what each field’s merge tag is named. then, you’d insert that merge tag into your content.

            For more info, you might search around http://mailchimp.com/help‘ for “merge tag”

            I also just heard that our video guy is working on some merge tag videos over at http://mailchimpacademy.blip.tv/

            • Tammy says:

              thank you Ben; I want to learn how to do this to get the most of the mail chimp experience!

              Any other suggestions on whatever will drive more traffic to the site are welcome!

              Tammy

        • Tammy says:

          Amanda – I’m trying to figure out the merge tags.

          I want to be able to hyperlink the word “profile” to each members mypage.

          what I got using the url: mergetag was the entire string http://www.blabla.cm/bla/bla/bla when I sent the actual email.

          How do i fix the problem where it will hyperlink the word “profile” to their page, without it displaying the page address?

          Thanks
          Tammy

      • Liz says:

        We are having a simular issue. The TOC works great, but only seems to pull titles from the main body and not the side column. How can the TOC include both?

    • Eric Rasch says:

      So, how do I know what HTML this is going to generate? I’d like to make sure the output is styled correctly with my CSS.

    • Ryan Campbell says:

      Great feature. I’m trying to implement this feature in our newsletter and can’t get it to render. I’m using “*|MC:TOC|*” in a tag. Any ideas?

    • WereBear says:

      I used it in my sidebar column, and it was wonderful! Even took the longer titles… which prompted me to shorten them.

      However, it quit before including the sixth title. I took it as a stylistic comment, but it might be a bug.

    • Charlie says:

      This is a great feature, but there are a couple of things that would make it even more useful for me:

      -if a title is long enough that it wraps to the next row, another bullet point is added. I don’t see any way to prevent this from occurring.

      -Would like to see some options about the style of the bullets – i.e. using dashes instead of points

      Thanks!

    • Deirdre Rusling says:

      Every time I log on I find you’ve added some new cool feature :-) This one will be a real timesaver – thanks!

    • Christiaan says:

      Just won’t render for me. Are there any common mistakes I might be making?

      I’m using it in a RSS campaign, along with:

      *|RSSITEMS:|*
      *|RSSITEM:TITLE|*

      *|RSSITEM:CONTENT|*

      comment | *|RSSITEM:DATE|*
      *|END:RSSITEMS|*

    • Christiaan says:

      Okay I figured it out. You actually have to select *|RSSITEM:TITLE|* and then apply the Title style to it in the editor.

Leave a Reply

* indicated required
http://www.mailchimp.com/nonrestrictiveocean.php