Model Timestamp

As we receive models from subcontractors or partners, we need to integrate them in a coordination model.

The coordination model files structure look like this.filestructure

In the coordination model, we use linked views and model specific overrides to fine tune model display. To keep these settings when a linked model is updated, we just override the previous liked file with its new version. This process implies to rename the file each time we receive a new version from a subcontractor. So when we receive a file named with a date or a version, we rename it along some quality control checks.


But we also have to follow which model version we are linking in our coordination model. Renaming files is great to keep the link alive, but we lost the original name in the process.

To keep track of the version of the linked file, I create some kind of timestamp on every object of a given model. This application writes version information on four shared parameters, common to every object.

Once in the coordination model, these shared parameters allows us to know from which version a given element came from.


They can also be used to create filters to highlight the origin of each element in a view.

I also find some very interesting side effects. For example, I create a linked models schedule with a multi-category schedule displaying only the four shared parameters.


My only concern is the performance of such an application. I run it on the Revit MEP example file, and it take 31 seconds, regeneration included. It could easily handle a larger model, but the user will then need some patience as the application run.

You will find below a piece of code I use to write values on every elements of the model. This code does not include any interface, but I hope to be able to publish a packaged version anytime soon.


public void ModelTimeStamp()
	Document doc = this.ActiveUIDocument.Document;
	using (Transaction tx = new Transaction(doc)) {

		tx.Start("Model TimeStamp");

		//Create a list of category
		CategorySet myCategories = CreateCategoryList(doc, this.Application);

		//Retrive all model elements
		FilteredElementCollector collector = new FilteredElementCollector(doc);
		IList<ElementFilter> categoryFilters = new List<ElementFilter>();

		foreach (Category category in myCategories)
			categoryFilters.Add(new ElementCategoryFilter(category.Id));

		ElementFilter filter = new LogicalOrFilter(categoryFilters);

		IList<Element> elementList = collector.WherePasses(filter).WhereElementIsNotElementType().ToElements();

		//Add the value to all element
		if (elementList.Count > 0)
			foreach (Element e in elementList)
				WriteOnParam("Date", e, DateTime.Now.ToShortDateString());
				WriteOnParam("Version", e, "First Release");
				WriteOnParam("FileName", e, "SubContractors Model");
				WriteOnParam("Trade", e, "HVAC");



private void WriteOnParam(string paramName, Element e, string value)
	IList<Parameter> parameters = e.GetParameters(paramName);
	if (parameters.Count != 0)
		Parameter p = parameters.FirstOrDefault();
		if (!p.IsReadOnly)

private CategorySet CreateCategoryList(Document doc, Autodesk.Revit.ApplicationServices.Application app)
	CategorySet myCategorySet = app.Create.NewCategorySet();
	Categories categories = doc.Settings.Categories;

	foreach (Category c in categories)
		if (c.AllowsBoundParameters && c.CategoryType == CategoryType.Model)

	return myCategorySet;

5 thoughts on “Model Timestamp

  1. Hi,
    I was triggered to your Add-in Model Timestamp because I was looking for a tool getting a list (schedule) of all used Linked Files at a coordination model.
    So I installed your Add-in and run your app at two models getting the Parameters setup. At one of these models (other is linked) I tried to get a list of the other linked model. I only get information from the previous model! Did I do something wrong?
    Other thing. The objects are having set the parameter from your app. When I change one of these objects from 0 to A it isn’t a problem. After I run Model Timestamp again it was all setup to the 0 parameter! I’d like still to have the changed A parameter setup manually. Is that possible (in future)?

    • Hi,

      If you want to create a linked models schedule, you have to check the ” Include elements in links” checkbox in the Fields panel to include properties from the linked model.

      About your improvement, it is something that could totally be done, I will integrate it in the next release.

      Best regards,

  2. Instead of assigning these parameters to the file can you time stamp each family by username , date modified, and time stamp? This would allow filters to be created for seeing what has changed from week to week for coordination.

Leave a Reply

Your email address will not be published. Required fields are marked *