Connect Your Own Domain: Your App at Your Own Address
Starting with the Premium plan, your app can run under your own domain if you wish—for example, app.cafe-am-markt.de instead of cafe-am-markt.zur.app. You enter the domain in the admin panel and create a record with your domain provider. The system takes care of the rest: It verifies the entry, has the certificate for the secure connection (HTTPS) issued, and only switches over once both are correct. If you don’t have a domain yet, we’ll register one for you.
Your previous address will remain associated with your app and will continue to redirect, including any links and QR codes you’ve already shared.
Who can connect their own domain
- Premium and up: with an active Premium or Executive plan. During the trial period and in the Light plan, the text “Premium and up” appears; clicking it takes you to the plans via “Change Plan.”
- Registration included: Starting with the Premium plan, we’ll register a domain with the .de, .com, or .eu extension for each app for as long as the plan is active. You’ll need to provide your own domain with a different extension.
- Apps from “Get Started with AI”: only after you’ve confirmed your legal notice. Until then, the line remains inactive, just like the address field.
Subdomain or main domain?
- Subdomain (recommended), such as app.cafe-am-markt.de: Your website remains at cafe-am-markt.de as is, and the app gets its own address alongside it. To set this up, create a CNAME record with your provider.
- Main domain, such as cafe-am-markt.de: The domain will then point to the app instead of your website. To set this up, create an A record with your provider.
The control panel will show you which record you need as soon as you enter your domain. Email addresses associated with your domain are linked to other records and will remain unchanged in both cases.
Step 1: Enter the domain
Under App › Edit Structure › Settings › Publish, in the “Set Address” section below your app’s address, you’ll see the line “Connect your own domain”:
- Your app’s address: the address on zur.app. It remains associated with your app even if your own domain is connected, and will then redirect.
- Connect your own domain: Opens the sheet. The example below uses your app’s name.
In the sheet, enter the domain and select where it comes from:
- The three steps: “Domain,” “Entry” (or “Registration” if registering a domain), and “Connected.”
- Your domain: without https:// and without a path. If you enter a full address, the system will only use the domain portion.
- I already have the domain: You already own the domain. You create an entry with your provider; the system will show you which one.
- Please register it for me: We’ll register the domain for you and link it to your app. The package includes a domain with a .de, .com, or .eu extension for the duration of the package.
- Recommendation: a subdomain that reflects your app’s name.
- Next: Submit the request. If you select “I already have the domain,” the system will check it right away.
If the domain doesn’t match, the reason will be displayed in the field; see “If there’s a problem.”
Step 2: The entry with your provider
If you select “I already have the domain,” the sheet will display the entry you need to create with your domain provider after clicking “Next”—usually under “DNS”:
- The entry: Type, Name, and Destination. The buttons next to them copy the Name and Destination.
- Status: “Entry found,” “Certificate issued,” and “Connected,” with a description of what’s currently happening below each.
- Last check, e.g., “Last check 3 minutes ago.”
- Check Now: Checks immediately, at most once per minute. If you check earlier, it shows when the next check will take place.
- Cancel: Ends the request after a confirmation prompt. Your app remains at its address.
Here’s what the entry looks like:
- For a subdomain like app.cafe-am-markt.de: Type “CNAME,” Name “app,” and the target is your app’s address on zur.app, such as cafe-am-markt.zur.app.
- For a main domain like cafe-am-markt.de: Type “A,” Name “@,” and as the value, the address shown in the control panel. Some providers leave the Name field blank for this.
If there’s already an entry under that name—for example, for your website—edit it instead of creating a second one. Delete any AAAA (IPv6) entries under that name; otherwise, the certificate cannot be issued. If the check finds one, the sheet will indicate it:
- The A record for a top-level domain: Name “@,” with the address displayed in the management interface as the value.
- No AAAA record: The check found an AAAA record. Delete it from your provider’s system.
You may close the sheet: The check will continue without you.
Wait: What the steps mean
Until the domain is connected, “Set Address” displays its status:
- The status, in this case “Waiting for the DNS record.”
- The last check or what it found.
- View entries: opens the sheet with the entry and the status.
The statuses in order:
- Waiting for the DNS record: The system cannot find your record yet. Depending on the provider, it takes a few minutes—rarely a few hours—for a new record to take effect everywhere.
- Certificate being issued: The record is correct. The certificate will be issued automatically, usually within a minute.
- Connected: Your app is running under your domain; see “Connected: What Changes.”
The system checks every five minutes for two days, then every hour. If it still isn’t working after two days, you’ll receive an email and a notification explaining the reason. After 14 days without success, the request ends with an email: It will then say “Not connected,” and clicking “Check Again” will resume the process and check immediately. As long as “Publish” is active, the system checks the status every minute.
Please register for me
With “Please register this for me,” we’ll take care of everything—you don’t have to enter anything:
- Requested: the domain, when you requested it, and “included starting with Premium.”
- Here’s what happens next: If the domain is available, our technical team will register it, usually within two business days. We’ll set up the entry ourselves, and the certificate will be issued automatically. If it’s already registered, you’ll receive an email and a notification.
- Withdrawing a request: Please ask us first. We will then not register the domain.
If the domain is already taken, we’ll get back to you with a suggestion. We can register one domain per app with a .de, .com, or .eu extension. If you want another one or one with a different extension, you’ll need to provide it yourself (“I already have the domain”).
If there’s a problem
If the check finds something that’s not right, the spreadsheet explains in plain language what the problem is and what to do. The step includes a short note, such as “Found: … instead of …,” along with “Check again”:
- What’s wrong: here, the domain points to a different location. The spreadsheet lists what the check found and what needs to be done.
- The status indicates which step is causing the issue.
- Check again as soon as you’ve changed the entry.
The messages and what to do:
- “There is no entry yet for …”: Create the entry from the spreadsheet with your provider.
- “… points to somewhere else”: There’s a different entry under that name, such as your website’s. Change it to the entry from the spreadsheet.
- “… also has an AAAA record (IPv6)”: Delete the AAAA record from your provider’s system.
- “The certificate didn’t arrive” or “The certificate couldn’t be issued”: The entry is correct; the system will keep trying. If the issue persists, support will assist you.
- “… not responding”: The entry is correct, but there was no response from the domain. The system will check again.
- “… already belongs to another app”: If this is also your app, disconnect the domain from there first. Otherwise, support will help you.
As soon as you start typing, the field will indicate if a domain is invalid: no extension (“The extension is missing.”), not a valid domain, an address on zur.app (which you select in the “Your app’s address” field above), a domain that’s already linked to or requested for another app, or a domain belonging to the platform itself, such as appconfector.de (“This domain belongs to the platform and cannot be linked.”). When registering, if the extension is other than .de, .com, or .eu, or if the included registration is already in use, you’ll also see an error.
Connected: What Changes
As soon as the entry and certificate are correct, the system switches over. You’ll receive the email “Your domain is connected” and a notification. If you have “Publish” open at that moment, the admin panel will also display: “Connected: Your app is running at …”.
- Your app’s address: now your domain, with “Connected.”
- The address on zur.app redirects, as do links and QR codes containing this address.
- Back to the platform address—see below.
What this means for you and your users:
- Links and QR codes: The old address still leads to your app, including via printed QR codes. “Share QR Code” on the dashboard now displays the code with your domain.
- Anyone who opens the old address will see a message, such as “Café am Markt has moved and is now available at app.cafe-am-markt.de. Tap OK to open the new address. If you’ve already installed the app, reinstall it there.”
- Installed web apps will display this message the next time they’re launched. Tapping “OK” opens the new address, where your users can add the app to their home screen again.
- Apps from the App Store or Google Play will continue to run as usual without any notification.
- Search engines are redirected to the new address and will gradually adopt it.
- History: Your app’s history will show “Custom domain connected: …”. This entry cannot be undone; to revert, select “Return to platform address.”
- The entry remains: Leave it with your provider; without it, your app won’t be accessible under your domain. The system checks the domain once a day. If it no longer points to us, this will be indicated in “Set Address.”
On the dashboard, under “App Ready to Go,” the “Custom Address” item is marked as complete. The “App Address” field under Settings > General is locked when a custom domain is set.
Back to the Platform Address
“Back to Platform Address” under the connected domain prompts you beforehand and explains what will change:
- Your app will then run again at its address on zur.app.
- What changes: Links and QR codes will continue to work with both addresses as long as your domain points to us. Installed apps will move with it: The next time you launch the app, a notification will inform you that the app has moved, and it will be reinstalled at the platform address. If you leave the entry as is, you can reconnect the domain later without creating a new entry.
- Important note: If you delete the entry with your provider, links and QR codes using your domain will no longer be accessible.
- Back to the platform address: Switch over. You’ll receive an email, and your app’s history will show “Back to the platform address: …”.
After that, “Set Address” will again show “Connect Your Own Domain,” and below that, it will indicate that your domain will continue to redirect as long as it points to us.
Frequently Asked Questions
Can my app run under my website’s address?
Yes, with the main domain, but then it will point to the app instead of your website. Usually, a subdomain like app.cafe-am-markt.de is better: Your website stays the same, and you link to the app from there.
How long does it take for my domain to be connected?
Usually just a few minutes after your entry takes effect. How quickly a new entry takes effect depends on your provider; rarely does it take a few hours. Registration through us usually takes up to two business days.
Will old links and QR codes still work?
Yes. Any address your app has ever had remains associated with it and redirects, even after multiple changes. A custom domain that is no longer connected will redirect as long as its registration points to us.
Do my users need to reinstall the app?
Users who pinned your app from their browser to their home screen will see a notification the next time they open it and will repin it under the new address. Apps downloaded from the App Store or Google Play will continue to work as before.
How much does a custom domain cost?
Domain linking is included starting with the Premium plan, as is the registration of a .de, .com, or .eu domain for the duration of your subscription. If you use your own domain, you’ll continue to pay your provider as before.
Can I connect multiple domains to one app?
Only one can be connected at a time. To connect another one, first go to “Back to Platform Address” and then connect the new one.
I see “Not connected” and don’t know what to do next.
Open “View Entries”: At the top of the sheet, you’ll see the results of the last check. Correct the entry and select “Check Again.” If that doesn’t help, contact us via “Help” > “Chat with Support”; the support team can see the status of your request and will check it right away.
Do I change the domain under “App Address” in the settings?
No. If you’re using your own domain, that field is disabled. You can connect a different domain in “Publish,” after “Back to Platform Address.”