Settings
Account Settings Overview
General
13 min
the general tab allows you to edit your account name and domain provided during the creation of the account these settings are essential for identifying your organization within swimlane turbine and may be used in various integrations and authentications note the general settings are only available to turbine administrators changes to the account name or domain fields can affect integrations and authentication configurations ensure you have verified the changes before saving steps to edit the account name and domain follow these steps to edit the account name and domain click on your profile in the top right corner and select admin panel from the dropdown menu from the left navigation menu, select settings > account > general click > to expand the basics section input your new account name in the account name field and update the domain name in the domain field as needed click save to apply the changes general tab in admin panel showing account name and domain settings custom domain a custom domain is a personalized web address that a company owns and controls — for example, instead of using a generic url provided by swimlane, you have the flexibility to customize it to better align with your branding, address your customers' needs, and mitigate any security concerns you may have example instead of using region swimlane app, a cybersecurity automation company could set up yourcompany swimlane app requirements and considerations for adding a custom domain in swimlane before you configure a custom domain in swimlane, check the following prerequisites and important notes administrator access required only users with account admin permissions can configure a custom domain access to dns records custom domains require updates to your dns records this setup typically involves coordination with your it team or network administrator to ensure proper dns configuration domain format for security to maintain platform security and protect against man in the middle (mitm) attacks, swimlane requires custom domains to follow this structure \<subdomain> \<subdomain> \<domain> example customer swimlane app enable custom domain step 1 add a custom domain navigate to settings > account settings > general the basic/default domain is enabled automatically to add a custom domain click +add custom domain in the first page add custom domain page, enter the valid domain name in the domain field in the valid domain pattern note the character limit is 62 characters if the domain name is valid, then the next button is enabled and you can move to the dns instructions step step 2 update the dns provider to update the dns records copy the automatically displayed retrieve instructions to configure your dns setup access your dns provider log in to your dns provider and navigate to the settings add 2 new cname records create cname records record type select cname host/name this will usually be the subdomain you are configuring, like www or something like verify value \ enter the value provided on the screen you saw (it is not shown in your screenshot but would be displayed once retrieval completes) ttl (time to live) set to default or choose a low ttl like 5 minutes to speed up propagation (not mandatory) save the changes, and wait for them to propagate this can take a few hours depending on the dns provider and ttl settings step 3 verify and prepare to enable your domain once the status of your domain shows verification complete and both checks (dns check and issue certificate) are marked as complete , once validated and obtained the certificate to proceed with activation follow the custom domain setup wizard to step 4 (enable) activate the custom domain for your swimlane instance step 4 enable and finalize custom domain setup now that your custom domain has been successfully added and verified all configuration steps—including adding the domain, setting up dns records, and issuing the ssl certificate are completed to activate the new domain, enable the enable new custom domain toggle once enabled, all users will be required to access the platform using the new domain click save & close to finalize the setup and apply the changes the original swimlane url (fallback url) will still be functional however, when users access it, they will be redirected back to the custom domain for a consistent and branded experience disable the custom domain to disable the custom domain, click disable if you click disable on the custom domain the system will deactivate the test customdomain swimlane io all access will be redirected back to the default swimlane domain test swimlane app any saved bookmarks, email links, or integrations using the custom domain will no longer work unless updated delete the custom domain click the three vertical dots (⋮) next to the custom domain, then select delete from the dropdown menu the custom domain test customdomain swimlane io is removed from the system you will no longer be able to access swimlane via that domain to access you have to re add it and reconfigure dns any dns verification, tls certificates tied to that custom domain will also be discarded the platform reverts to using the default domain test swimlane app, which remains available how it works url behavior your swimlane default url will remain functional after the custom domain is activated accessing the swimlane default url will redirect users to the custom domain if you deactivate your custom domain,swimlane default url will start functioning if the domain configuration is deleted or the product is unlinked from the domain, the custom domain will not revert to the default url once activated you will be able to access swimlane using the new custom domain ssl/tls security will automatically apply, ensuring encrypted and trusted connections you will seamlessly redirect to the custom domain when accessing the platform when a custom domain is enabled, all shared links will use your custom domain instead of the default swimlane domain these links may be sent to users for purposes such as password reset scheduled reports report downloads