Skip To Content

Update Annotation Reference Scale


Updates the reference scale of an existing annotation feature class.


  • Before an annotation feature class can have its reference scale updated, it must be upgraded to the current release using the Upgrade Dataset tool.

  • Caution:

    This tool modifies the input data. See Tools that do not create output datasets for more information and strategies to avoid undesired data changes.

  • Versioned annotation feature classes cannot have their reference scale updated.

  • Changing the reference scale of an annotation feature class is an intensive operation that requires an update of every feature's bounding box geometry.

  • An ArcGIS Desktop Standard or ArcGIS Desktop Advanced license is required to update the reference scale of a feature-linked annotation feature class.


UpdateAnnotationReferenceScale_cartography (in_anno_features, reference_scale)
ParameterExplanationData Type

The input annotation features.

Feature Layer

The annotation feature class reference scale to be updated.


Code sample

UpdateAnnotationReferenceScale example (Python window)

The following Python window script demonstrates how to use the UpdateAnnotationReferenceScale tool in immediate mode.

import arcpy
arcpy.cartography.UpdateAnnotationReferenceScale("C:/data/Canada.gdb/cities", 4000000)


This tool does not use any geoprocessing environments.

Licensing information

  • ArcGIS Desktop Basic: Yes
  • ArcGIS Desktop Standard: Yes
  • ArcGIS Desktop Advanced: Yes

Related topics