# ▪️ How do I import and synchronize users from my directory server(s)?

:::info
Available to users with Admin role.

:::

If a directory server is [**configured for synchronization**](/doc/31cd3bb4-9857-44c9-96b7-6a7c33feb9d8), groups can be created in the [**User Manager**](/doc/5ad41734-a805-4712-8aff-6d8f8f11b37a) module by importing users from the directory server. Imported groups can then be synchronized later on.


:::warning
Only users imported from your directory server can be synchronized. Users originally created in **LearningSpace Experience** cannot be synchronized, even if their data matches a user stored on the directory server.

:::


1. Create or open a group you want to import users into.
2. Go to the **LDAP** tab.  
     
   ![](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/6c0da235-ff99-49fd-81af-d32f613692dd/2b86dee8-67c6-4928-89fd-b86a456120f8/55804142.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20260909%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260909T144500Z&X-Amz-Expires=86400&X-Amz-Signature=3c2a80928ebaae07d0c32c56ba864cc1f382ae117fd4e539ee41e08adef950ac&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =672x198")  
3. Turn on *Enable* at LDAP sync.  
   Further settings will appear in the tab:  
     
   ![](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/6c0da235-ff99-49fd-81af-d32f613692dd/8615d04e-a5ce-4fcd-b9ba-73df35612cfa/55804141.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20260909%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260909T144500Z&X-Amz-Expires=86400&X-Amz-Signature=36a87375a924ff95a104d59f430304fe620ba9cc271571fe3ae017c0b235f12b&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =672x490")  
4. Select a directory server from the drop-down if multiple directories are configured for synchronization.
5. The query base is automatically passed down from [**LDAP Synchronization Settings**](/doc/31cd3bb4-9857-44c9-96b7-6a7c33feb9d8)**.**  

   
:::info
   To change the **Query base**, return to [**Directory Access Settings**](/doc/9d83c700-dcee-49ee-b148-8c74eaec8580) in the [**System**](/doc/be5530d2-d0c0-4f40-aa21-0a3f564330ce). The settings can be accessed with the **Admin** role.

   :::
6. Define a **Query filter** to identify the users you want to import from the query base.

   
   
:::tip
   Place an asterisk ('**\***') before, after, or inside an attribute's value to apply it as a wildcard operator.

   Place a question mark ('**?**') before, after, or inside an attribute's value to substitute for any character.

   :::

   ![](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/6c0da235-ff99-49fd-81af-d32f613692dd/2a4b256e-d12f-4e98-a9b3-7acd7724d128/55804140.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20260909%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260909T144500Z&X-Amz-Expires=86400&X-Amz-Signature=6235d0be8b90dec4e3d0915fde2cf663ccecdab22461088b4783031fd9d34e2c&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)  
     
7. Select a **role** for the imported users.

   
:::info
   Upon synchronization, all members will get the selected role assigned.

   :::

   ![](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/6c0da235-ff99-49fd-81af-d32f613692dd/f4b6b8a1-fa1b-412d-af6d-c0c01084323c/55804139.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20260909%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260909T144500Z&X-Amz-Expires=86400&X-Amz-Signature=0cc583291c2384878bf44953506a463a7877952544476b25da124979eea22a5b&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =672x489")

   ### **'Propagate Membership Removals from Directory Server' Option**

   If the option is selected, the directory server membership removals will also apply to **LearningSpace Experience**. If a synchronized user is removed from the directory server group, the user will also be removed from the **LearningSpace Experience** group upon the next synchronization.

   
:::info
   Users will only withdraw their group membership but will not be deleted; the removed users will still be registered in your LearningSpace Experience system.

   :::

   ![](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/6c0da235-ff99-49fd-81af-d32f613692dd/fef5e295-1e40-4b31-8b4d-559439947c6e/55804138.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20260909%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260909T144500Z&X-Amz-Expires=86400&X-Amz-Signature=7a23415c9403a45950b0737e045ba41d5fceec0e3a91fdabbc139360d458cba8&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

   
8. Click **Sync Now** to perform a manual synchronization.

   
:::info
   **LearningSpace Experience** automatically synchronizes imported user groups during regular nighttime system maintenance.

   :::

   
   1. If you are only importing users, the system will show you how many new users are being created:  
        
      ![](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/6c0da235-ff99-49fd-81af-d32f613692dd/39294d08-efd9-4589-8ecd-d31c4ba01938/55804137.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20260909%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260909T144500Z&X-Amz-Expires=86400&X-Amz-Signature=c44175e9f08383f12041d4bd979b75717f6d245b03b78afd1d99f5ce0ba4dc59&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)  
   2. If there are previously imported users who are being updated, the system will also show you how many updated users you will have in the group:  
        
      ![](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/6c0da235-ff99-49fd-81af-d32f613692dd/c531fe6d-923f-4132-9db2-d0ccefaa3596/55804136.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20260909%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260909T144500Z&X-Amz-Expires=86400&X-Amz-Signature=dc839aa85ec8da733a39e32d46f86afd1d1ca8cf3ea0b5d27aec7d499fd45ad4&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

---

**Documents**

- [User Guide](https://kb.learningspace.elevatehealth.net/s/exp-hs/doc/user-guide-oarr3rXNmH)
- [FAQ](https://kb.learningspace.elevatehealth.net/s/exp-hs/doc/faq-YLwvsQzPg1)
- [Training Videos](https://kb.learningspace.elevatehealth.net/s/exp-hs/doc/training-videos-TEIl08kVIW)
- [Release Notes](https://kb.learningspace.elevatehealth.net/s/exp-hs/doc/release-notes-W7WkHQOdlB)
- [iPad support - Technical information](https://kb.learningspace.elevatehealth.net/s/exp-hs/doc/ipad-support-technical-information-CvKg62sptV)
- [Customer Aftercare One-Pager](https://kb.learningspace.elevatehealth.net/s/exp-hs/doc/customer-aftercare-one-pager-fm7WLpsnDM)