Skip to main content

Administration and Configuration

Complete guide to administering and configuring your Atlan workspace, from basic settings to advanced customization.

How do I change my Atlan URL?

To change the URL of your Atlan instance, contact Atlan support. Requests for instances hosted on Microsoft Azure and Google Cloud Platform may take longer to complete.

If you use integrated SSO in Atlan, ask your SSO administrator to reconfigure the Atlan URL in your SSO provider to maintain connectivity.

How can I change the workspace name?

You must be an admin user to be able to change the name of your Atlan workspace.

To update the workspace name:

  1. From the left menu in Atlan, click Admin.
  2. In the Overview tab, under Workspace name, click the pencil icon to edit the workspace name.
  3. In the Workspace name dialog, enter a name for your Atlan workspace and then click Update.

For example, you can use the name of your organization to customize your Atlan workspace. After you update the name, the change is visible to all your Atlan users.

How can I add my own branding?

To add your own logo to Atlan, any admin user can go to the Admin Center and click the image in the Overview section to upload a new logo. Atlan resizes the logo automatically, maintaining its aspect ratio.

Atlan recommends that you use the following size and format for your logo:

  • A logo with a 1:1 aspect ratio
  • In either PNG or JPEG format
  • With a size of 150x150 pixels

I am having issues editing a persona, purpose, or policy

If you have the Admin role (or another role that grants edit access) but still can't modify a persona, purpose, or policy, check the name of the item you are trying to change. Names can't include special characters such as \\, *, and similar symbols. Dashes (-) are allowed.

If the name already contains unsupported characters, or you continue to encounter errors after correcting the name, please raise a support ticket.

How do I access audit logs?

Open any asset's activity log and audit all activity by using the auditSearch API. Configure the request with your preferred filters—such as time range or action type—to retrieve the audit records you need.

Can restricting access to certain assets impact the lineage view?

Access control policies don't change which assets appear in the lineage graph. If an asset is restricted, its properties and attributes are simply hidden in the asset sidebar. The metadata policy assigned to each user determines which asset metadata they can view.