Clone a Group

This sample notebook can be used for cloning one or more groups, either on the same portal or from one portal to another.

Note: If you want to clone all portal users, groups and content refer to the sample Clone Portal users, groups and content

In this sample, we will clone the Vector Basemaps group from ArcGIS Online to an ArcGIS Enterprise.

from arcgis.gis import GIS
from IPython.display import display
from arcgis.gis import ItemProperties

Define the source and target portals

To start with, define the source and target portals.

# an anonymous connection to ArcGIS Online is sufficient, 
# since we are cloning a public group
source = GIS()

target = GIS(profile="your_organization_profile")

Search for the group and its contents in the source portal

In the source portal, search for the group to be cloned. In our case the title of the group is 'Vector Basemaps'.

source_groups = source.groups.search("title:Vector Basemaps AND owner:esri", outside_org = True)
source_groups

[<Group title:"OpenStreetMap Vector Basemap" owner:esri>,
 <Group title:"United States Vector Tile Layers" owner:esri>,
 <Group title:"Vector Basemaps" owner:esri>,
 <Group title:"Vector Basemaps (for Export)" owner:esri>]

source_group = source_groups[2]
source_group

Vector Basemaps

Summary: This group contains a set of Esri vector basemaps that are available for use in ArcGIS Online. The group contains both web maps and tile layers.
Description:

For several years, Esri has made available a suite of basemaps that can be used through ArcGIS Online and other apps to create maps and apps. These multi-scale basemaps have been delivered as pre-rendered image tiles (JPG or PNG format) to optimize performance. These basemaps have proven to be very useful and popular, with several billion tiles served each month, but they have some limitations (e.g. users can not customize map, low-res image tiles not optimal for display on high-res devices, etc.).

To provide additional options for users, Esri has introduced a new set of vector basemaps. These basemaps are delivered as vector tiles (PBF format) that are rendered client-side based on a style file that is delivered with the vector tiles. Vector basemaps are available in Map Viewer and Scene Viewer, as well as in ArcGIS Pro, configurable apps that include a basemap gallery, Workforce for ArcGIS, Explorer for ArcGIS, and apps created using Web AppBuilder. To find out whether vector basemaps are available in a specific ArcGIS app, refer to the app documentation. Users are able to customize the look and feel of the vector basemaps by creating custom styles that are used to render the vector tiles.

Available Vector Basemaps

This group includes vector basemaps in multiple styles, some that closely resemble existing Esri basemaps (e.g. Streets, Topographic, Light and Dark Gray Canvas, Terrain with Labels), and others that are new (e.g. Streets at Night, Navigation, and Imagery Hybrid). The group also includes several more 'creative' styles (e.g. Colored Pencil, Charted Territory, Mid-Century, Modern Antique) that are optimized for specific uses. It also includes a new OpenStreetMap vector basemap created and hosted by Esri. The vector basemaps are available as both web maps, which can be used as a basemap for adding other layers, and as tile layers, which can be added to existing maps either as a basemap or overlay layer.

Learn More

To learn more, including how you can customize the Esri vector basemaps, you can refer to the blog posts tagged with "vector basemaps". You can also use the new Vector Tile Style Editor app to quickly create your own custom map. The Vector Tile Style Editor app has now been integrated with ArcGIS Online so it is accessible from vector tile layer items in the ArcGIS.com Map Viewer.

Owner: esri
Created: October 27, 2015

List the items that are a part of the group 'Vector Basemaps'.

source_items = source_group.content()
source_items

[<Item title:"Colored Pencil Map" type:Web Map owner:esri>]

Clone the group in the target portal if it does not already exist.

We create a new group in the target portal with all the properties of the group in the source portal.

import tempfile
if not target.groups.search('Vector Basemaps'):
    try:
        with tempfile.TemporaryDirectory() as temp_dir:
            thumbnail_file = source_group.download_thumbnail(temp_dir)
            
            #create a group in the target portal with all the properties of the group in the source
            target_group = target.groups.create(title = source_group.title,
                                                 tags = source_group.tags,
                                                 description = source_group.description,
                                                 snippet = source_group.snippet,
                                                 access = source_group.access, 
                                                 thumbnail= thumbnail_file,
                                                 is_invitation_only = True,
                                                 sort_field = 'avgRating',
                                                 sort_order ='asc',
                                                 is_view_only=True)
            #display the group
            display(target_group)
            
    except Exception as e:
        print('Group {} could not be created'.format(source_group.title))
        print(e)
else:
    print('Group {} already exists in the portal'.format(source_group.title))
    target_group = target.groups.search('Vector Basemaps')[0]

Vector Basemaps

Summary: This group contains a set of Esri vector basemaps that are available for use in ArcGIS Online. The group contains both web maps and tile layers.
Description:

Available Vector Basemaps

Learn More

Owner: esri
Created: July 08, 2025

Clone the contents of the group to the target portal

It is possible that some items to be cloned may already be present on the target portal. In such a situation, we simply share those items with the target group. Thus, in the section below, we renew our list of items to be cloned by removing from it, any item that was existing on the target portal beforehand.

#making a list for the items to be cloned in the target portal
items_to_be_cloned = list(source_items)

#checking for the presence of the item in the target portal 
for item in source_items:
    searched_items = target.content.search(query='title:'+item.title, item_type = item.type)   
    
    for s_item in searched_items:
        
        if s_item.title == item.title:
            
            #if an item is not a part of the group in the target portal then share it 
            if s_item not in target_group.content():
                s_item.sharing.groups.add(
                    group=target_group
                )
            
            #remove the already existing item from the list of items to be cloned
            items_to_be_cloned.remove(item)                
            
            #display the item
            display(s_item)      
                     
            break

Note: The GroupManager.clone() doesn't clone the group’s items, it only recreates groups from site A to site B.

Now after having removed the existing items from the list of items to be cloned, we can easily copy the remaining content of the source group to the newly created group in the target portal.

#cloning all items that were not present on the portal before
for item in items_to_be_cloned:    
    try:
        thumbnail_file = item.download_thumbnail()
        target_item_properties = ItemProperties(title=item.title,
                              tags=item.tags,
                              text=item.get_data(try_json=True),
                              item_type=item.type,
                              snippet=item.snippet,
                              description=item.description,
                              thumbnail=thumbnail_file)        
        #create an item
        root_folder = target.content.folders.get()
        job = root_folder.add(item_properties=target_item_properties, item_id=item.id)
        target_item = job.result()
        #share that item with the group on the target portal
        target_item.sharing.groups.add(
            group=target_group
        )
        
        #display the item
        display(target_item)
            
    except Exception as e:
        print('Item {} could not be created in the target portal'.format(item.title))
        print(e)

Colored Pencil Map
This world basemap features symbolized with the appearance of being hand-drawn by colored pencils. (World Edition)

Web Map by esri
Last Modified: July 08, 2025
0 comments, 0 views

Please see GroupMigrationManager for offline exporting of group items