Replace Attributes by File: Automate Attribute Migration

by GRAPHISOFT, Katica Avvakumovits, JamesBadcock and Katalin Borszéki · updated: 06.13.2013

If you are migrating multiple similar project files to Archicad 17 , the Replace Attributes by File function can help you speed up the migration process: it automates the Delete and Replace attributes function, instead of you having to issue repetitive “Delete and Replace” commands in each attribute settings dialog.

Note: Only those attributes that support “Delete and Replace” are supported. These include Layers, Line Type, Fill Types, Composites, Profiles, Surfaces, Building Materials and Zone Categories. Other Attributes will be ignored in the Replace Attributes process.

The Replace Attributes by File command is not included in the default Work Environment of ARCHICAD 17. You must add this command to one of your menus (see below) before you can use it.

Before proceeding, it is advised to back up your project files, in case you need to go back at any stage. This function, once it is run, is not undoable.

Add Command to Work Environment

1. Go to Options > Work Environment.

2. Go to Command Layout Schemes > Menus

3. Filter the list of command using “All commands by theme”, and locate the Replace Attributes command in the 01 File folder.

4. Drag the Replace Attributes command from the left-hand list into the desired menu on the right.

  • 1.png

Preparing Attribute Replacement Text File

1. Have a new template file or an already migrated file available. The attributes in this file will be used as the “replacement” attributes.

2. Open a “to be migrated” file on which you wish to use the automated attribute replacement function.

3. Open Attribute Manager. On the right side, click “Open…” to load your template file from Step 1.

4. Select the attributes you wish to use as the “replacement” attributes, and “Append” them to the left side of the Attribute Manager – make sure you do this for all attributes that will serve as replacements.

5. From the “All” tab of Attribute Manager, use the “Print to File…” command. This will generate a tabbed delimited text file that contains all the attributes listed at left.

  • att2.png

Note: It is recommended to use “Print to File” from the “All” tab of Attribute Manager: This way, you can include all the project’s attributes in the generated text file. (If you “Print to File” from another tab, you will export only the attributes belonging to the selected tab – of course, this may be sufficient for your purposes.)

6. Open the generated text file in a spreadsheet application.

In Open Office application:

In this case, use the open command and choose the “Text CSV” file format to open the text file.

  • att3.png

  • attk.png

In Microsoft Office:

If you use Microsoft Excel, use the appearing conversion wizard (Note: Using drag and drop with the text file will not run this wizard, it is only available via the “Open” command):

  • In Step 1, choose “Delimited”.
  • In Step 2, for the Text qualifier option, choose “none”.
  • att4.png

  • In Step 3, select each column in turn and set its data format to “Text”.
  • att5.png

  • Click Finish to open the text file.
  • att6.png

7. In the “name” column, find the attributes you will use as replacements for the existing ones. Copy these name(s) and paste them into the last available column (after the “in use” column; column E in the image below), in the row of the attribute to be replaced. Thus, ARCHICAD will delete the attribute that is shown in the “name” column, and replace it will the attribute that you have pasted into the last column.

8. Do this for all applicable rows (i.e. all attributes to be replaced).

  • att7.png

9. Close the text file. It must be retained in the original tabbed delimited file format (.txt). In Excel, you will be prompted to save the file; click Save. (In Excel, click “Yes” at the appearing warning.)

10. With the ARCHICAD project open (from which you generated the text file), issue the Replace Attributes command.

11. At the file prompt, select the text file and click “Open”. The attribute replacement function will run automatically. If there is an error, the process is stopped and no attribute is replaced. A warning appears and the report window opens to indicate which row is problematic. (See Possible Problems, below.)

12. For other “to be migrated” files, repeat steps 2, 3, 4 and 10. You can reuse the prepared text file each time.

Possible Problems and How to Fix Them

In some situations, after you launch the function, an error warning will appear. In this case, the function is stopped and no attributes will be replaced.

Possible errors include:

  • Text file not generated from attribute manager
  • An attribute that is “To be deleted” is the same as the “replacement” attribute in the same row
  • “Replacement” attribute doesn’t exist. (All “replacement” attributes must be listed in under the “name” column and must exist in the project file.)
  • Invalid text characters
  • “To be deleted” attribute name appears more than once under the “name” column

The following rows of the Text file will be ignored:

  • “In Use” and “Attribute number” columns
  • Additional tabbed data
  • Unrecognized attributes. These include: Cities, Pen Sets, Pen Colors, Layer Combinations, MEP Systems, Operation Profiles
  • Rows that have no “replacement” attribute
  • Rows whose “to be deleted” attribute name does not exist in the project being migrated – such rows will be ignored when the command is run. However, the “replacement” attribute must be appended to the project file in Attribute Manager in order for the command to run at all.
  • Was this Helpful ?
  • 2   ​6

Related content

Attribute Manager

The Attribute Manager (Options menu) is a handy tool to create and manage the Company-standards in your ArchiCAD projects. Its commands allows you to copy (append, overwrite) attributes (Layers, Layer Combinations, Pens & Colors, Line Types, Fill…

Top 12 ARCHICAD Commands You Should Use all the Time

Would you like to work faster and more efficiently in ArchiCAD? We have collected 12 lesser known shortcuts in ArchiCAD International version that can ease your daily workflow: Highlight Toggle Shortcut: TAB Have you ever wanted to select a Zone instead…

Operation Profiles

Open this dialog box from the Model Review Palette’s pop-up at the top right, from Design > Energy Evaluation > Operation Profile, or with the Options > Element Attributes > Operation Profiles command. The Operation Profile is an ArchiCAD…

Saving Your Customized Work Environment

If you have customized a number of settings in Options > Work Environment , you may wish to save them for future use in other projects, so that your personalized Work Environment is ready for you when you start to work. Individual settings are…

Work Environment Schemes

Work Environment settings ( Options > Work Environment ) are divided into six self-contained schemes . Each scheme is a thematic collection of settings. 1. User Preference Schemes. These include a wide variety of your preferences for functions such…

Attribute Manager

Open the Attribute Manager from Options > Element Attributes > Attribute Manager. Displaying the dialog box might take some time, since it has to list all the attributes of the project. This dialog boxallows you to copy (append, overwrite)…


ArchiCAD Attributes are groups of defined settings available to your project. For example, Line Types and Surfaces are Attributes which you can apply to many project elements as you create them. You will access these attributes in the appropriate dialog…

Tips to Keep Your Projects Tidy

This article gives you some tips on how to keep your projects lean and tidy. It will also have a positive effect on your efficiency working on the project and on ARCHICAD's performance.