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

:::info
Available to users with User Manager or Admin privileges.

:::

If a directory server is [**configured for synchronization**](/doc/f51f62c5-59ef-430e-a514-23926e9a9c24), groups can be created in the [**User Manager**](/doc/user-manager-2Awfo14Cyj) 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 Essentials** 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/7c3684a5-f727-4a2e-a497-24cbf6b20df1/55804088.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=20260909T151500Z&X-Amz-Expires=86400&X-Amz-Signature=841634228a76cdfc212c2ac78cd1cd414b5a6e055aafb164f6309591061abc92&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)  
     
3. Switch 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/ba6e6bb2-a28d-436a-90a9-15762ae09077/55804089.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=20260909T151500Z&X-Amz-Expires=86400&X-Amz-Signature=20aff68d7a707901ab743e6e6a92833b312a52d0860c56d99c8fce6653b9f22c&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)  
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/f51f62c5-59ef-430e-a514-23926e9a9c24)**.**  

   
:::info
   To change the **Query base**, return to [**Directory Access Settings**](/doc/directory-access-settings-jzbz24tyW8) in [**System**](/doc/system-module-4DfmyZ4GUl). 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
   **Tips**
   * 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/8e7190af-e434-4aba-adc4-5778c22260d4/55804090.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=20260909T151500Z&X-Amz-Expires=86400&X-Amz-Signature=6d69f41eae172289785e49319e83e49a6b2c9e386a3146f4af22c5dc7e9aa345&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/a60108b0-d39d-458d-be26-9133bdacefa9/55804091.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=20260909T151500Z&X-Amz-Expires=86400&X-Amz-Signature=78a01ca83f1e3d79fa6120ef2e0bd9a181bd1805728f7dfff677445a4ec744cb&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)**'Propagate Membership Removals from Directory Server'** Option  
   If the option is selected, the directory server membership removals will also apply to **LearningSpace Essentials** as well. If a synchronized user is removed from the directory server group, then the user will also be removed from the **LearningSpace Essentials** group as well upon the next synchronization.

   
   
:::info
   Users will only be withdrawn their group membership but will not be deleted: the removed users will still be registered in your **LearningSpace Essentials** system.

   :::

   
   
:::warning
   Switch on this option only if you want to clear user data from your directory server as you remove users from the group in **LearningSpace Essentials**.

   :::

   ![](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/6c0da235-ff99-49fd-81af-d32f613692dd/2025989e-724c-4c5a-a3fe-6d42b62fd17e/55804092.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=20260909T151500Z&X-Amz-Expires=86400&X-Amz-Signature=9c5b9dcfb2bacc26b48e4e0301adb14ecfc532fa9197443d939aec978946e89c&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

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

   
:::info
   **LearningSpace Essentials** 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/f8ab63eb-edc6-4c62-a24f-112d04ffc590/55804093.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=20260909T151500Z&X-Amz-Expires=86400&X-Amz-Signature=8524765ecfe37f4498d8347994462eb40c2a8156b00e7aaebba5ed2359f13428&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/8a2cda39-3930-4284-8b5c-e85ebc4d0d04/55804094.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=20260909T151500Z&X-Amz-Expires=86400&X-Amz-Signature=e8a1cc56cf6bfe5813e6d345b9c6aa393cd065bb7d8af7a8e14055ed5fc12955&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

---

**Documents**

- [User Guide](https://kb.learningspace.elevatehealth.net/s/ess-hs/doc/user-guide-QPZfKJ0BV1)
- [FAQ](https://kb.learningspace.elevatehealth.net/s/ess-hs/doc/faq-AZnS7tDFgM)
- [Release Notes](https://kb.learningspace.elevatehealth.net/s/ess-hs/doc/release-notes-fqaGSPScxH)
- [iPad support - Technical information](https://kb.learningspace.elevatehealth.net/s/ess-hs/doc/ipad-support-technical-information-iHec00YAzm)
- [Customer Aftercare One-Pager](https://kb.learningspace.elevatehealth.net/s/ess-hs/doc/customer-aftercare-one-pager-GOIZYTEgud)
- [Preventing Copy-Paste in LearningSpace](https://kb.learningspace.elevatehealth.net/s/ess-hs/doc/preventing-copy-paste-in-learningspace-uEubHwXVD2)