How does Merge work?
How PPTMerge Works
PPTMerge has two modes: Slides and Presentations.
Slides mode
PPTMerge starts with a single-slide template presentation and merges your data into it.
Slides mode turns one template slide into a presentation with many slides, one for each record in your data file. One row in your Excel worksheet or one line in your CSV/Tab-Delimited data file becomes one slide in the merged presentation.
Slides mode is great for creating certificates, awards slides or similar presentations where you have a list of names, places, pictures, sounds or movies that you want to turn into a lot of identical slides in a hurry.
Each slide can have as many merge fields as you like.
Presentations mode
PPTMerge starts with a template presentation containing any number of slides. It creates copies of the template presentation. Each copy is customized with the data from one record in your data file. One row in your Excel worksheet or one line in your CSV/Tab-Delimited data file becomes a complete new customized presentation after the merge.
Here's how you'll use PPTMerge in practice
In a nutshell: PPTMerge uses "field names" that you define in your data file, searches for them in the PPT template file and replaces them with actual data from your data file.
Data files
Start with a data file in Excel XLS, Comma Separated Value (CSV) or Tab Delimited format. Here's a simple example from Excel:

A few important points to remember:
- PPTMerge ignores blank lines
- PPTMerge assumes that the first non-blank line contains the names of the fields you want to merge. For example, :Name: is the field name. The actual names you want to merge into your presentation are underneath it.
- Your data file can include more fields than you intend to use. Unused fields and data are simply ignored. That way, you can use a single data file to drive several different merges, each of which uses different data.
- Make your field names unique by putting them between colon characters, like :Name:. That way you can use the word "Name" in your PPT presentation in places where you don't want it replaced with live data and :Name: where you do want a replacement to occur.
- You can merge pictures, sounds, movies and the contents of external text files as well as text. You'll see an example of how to set up your data file for that in the section about Presentation mode.
Hint: If you'd rather not edit your data file to make the field names unique, you can add a FieldPrefix entry to the PPTMerge section of PPTools.INI
[PPTMerge] FieldPrefix=xxx
For example, if you make the FieldPrefix "xxx" as in the example, then you'd use xxxName rather than Name as the merge field when setting up your template presentation. Though Name is the field name in your data file, PPTMerge will look for and replace xxxName when it does the merge.
Once you have your data ready, you need to tell PPTMerge what to do with it. Where should it put all the text, pictures and so on? For that, you'll create a "template" PowerPoint file.
Template files
A template file is an ordinary PowerPoint file that you've added "merge fields" to. Merge fields are just bits of text or rectangles that tell PPTMerge where to insert merge data, how to format it, and which data to insert.
For text data, the merge field is the name of the field in the data file.
For example, if you're creating an awards presentation, you might have fields called :Name: and :Award: in your data file. Wherever you want to insert the name of the award winner in your presentation, simply type :Name: in a text box on one or more of the slides in your template presentation. Type :Award: wherever you want the name of the award to appear, and so on.
As we mentioned, make the field names unique by adding some special character. PPTMerge is very literal-minded. If you type:
The name of the next award winner is name
and merge the sample data above, you'll get
The Steve Rindsberg of the next MergeMaster winner is Steve Rindsberg
Instead, use :Name: and :Award: as the field names and type
The name of the next award winner is :Name:
Note: Upcoming versions of PPTMerge will probably require colons surrounding field names, so it's a good idea to get into the habit of using them now.
A Slides Mode example
Here's an example template file for just such an awards ceremony:

You've already seen the data we'll use for this project.
Important points to remember:
- For Slides mode, there can only be one slide in your template PPT file
- For each data field you want to merge, include the field name somewhere on the slide. Important points:
- The field name must be spelled exactly as it's spelled in the data file; uppercase/lowercase is signficant
- You can use the same field name multiple times on the slide if you like
- You don't have to merge every data field in your data file.
- This example only uses a few of the types of data Merge can work with. See the Presentations mode example for more ideas (pictures, movies and more). You can merge the same types of information in both modes. The only exception is @filename fields, which work only in Presentations mode.
When you're ready to merge:
- Click the Slides PPTMerge button on the PPTMerge toolbar
- When prompted, choose the file that contains your merge data
- When prompted again after a few seconds, supply a file name for the merged PPT presentation
- PPTMerge performs the merge and tells you when it's done.

Presentation Mode example
Instead of starting with a single slide and creating additional slides, Presentation mode starts with a single presentation and creates additional presentations, each identical to the template presentation, but with your data merged into it. In this section, we'll show you how to set up your data and template file for Presentation mode merges and also introduce some of PPTMerge's advanced features. Here's the data file we'll be using for this example (split into two screens to make it easier for you to read):

- @filename When PPTMerge creates multiple presentations, it names them automatically. It names the presentations 1.PPT, 2.PPT and so on. That saves you the trouble of naming each presentation as it's created, but how are you going to know whose data is in which PPT file? Easy! Add a @filename field to your data file. In the @filename field of each record, type the name you want PPTMerge to use for the PPT file it creates from that record's data. PPTMerge will now give the file the name you requested. You don't need to specify the full path; Merge asks where you want to save the merged presentations when you run the merge. (Hint: Excel thinks @filename is a formula and complains when you enter it; type '@filename instead -- ie, type a single-quote character first-- to tell Excel to treat it as text, not a formula).
- PIC: SND: VID: fields. Merge isn't just about text. It can merge pictures, movies and sounds too. You set these up as PIC (picture), SND (sound) and VID (video/movie) fields in your data file, then supply the full path to the picture, sound or video you want to insert in the data for each field.
- TXT: Merge can also insert the contents of external text files into your presentations. To do this, you use a TXT:name data field in the data file and a placeholder rectangle with TXT:name as its text, just as you'd do with other similar file-insertion data fields like PIC:, SND:, VID: etc.
- UNI: inserts the contents of Unicode-encoded text when you do the merge. This enables you to include text in languages like Chinese/Japanese that regular merge fields don't support.








