CrankPal Documentation
Open the app

Setup

Workshop profile and hours

Workshop details, map position, logo, opening hours and the parameters that drive bookings and parts approvals.

The workshop profile is where CrankPal learns how your business actually works: where you are, when you're open, how many customers you can take in at once, and below what amount you can fit a part without ringing the customer. This isn't paperwork to be filled in for its own sake — almost everything you enter here changes how the app behaves the next day.

You'll find it all under SettingsWorkshop. It needs the manage_workshop permission: if the tab isn't there, ask the owner to grant it. Changes aren't saved automatically — there is a Save changes button at the bottom, and if you switch tabs with unsaved work the app reminds you.

Workshop details#

Name, address, city, postcode, phone, email and website. These are the details that end up on customer reports, on your messages and on your public page.

The Address field has autocomplete: type three characters and pick a suggestion instead of typing everything out. When you pick one, CrankPal also fills in the city, postcode and map coordinates for you.

Two fields are read-only. The Country is fixed at sign-up and can't be changed here. The VAT number doesn't live in this card: it sits in the fiscal details card, together with your e-invoicing recipient code and verification status — see Fiscal data verification.

Map position#

Latitude and longitude decide one thing, but an important one: whether your workshop appears in the map locator on crankpal.com, where cyclists look for the nearest workshop. Without coordinates you are not on the map, even if the address is filled in correctly.

  1. Fill in the address and city

    The coordinate lookup starts from those. If either is missing, the button tells you instead of searching for nothing.

  2. Press «Find coordinates from address»

    CrankPal looks up the position and fills in the two number fields. If you picked your address from an autocomplete suggestion, the coordinates are often already there.

  3. Check it on the map

    The verify button opens the position on an external map. Make sure the pin sits on your shopfront and not in the middle of the road or on the wrong number: it happens with unusual street numbering, and in that case you can correct latitude and longitude by hand.

  4. Save

    Until you save, the coordinates found only exist on screen. Below the fields a status line tells you whether the workshop is visible on the website map.

An image file up to 200 KB. Anything larger is rejected with a warning: resize the image before trying again, you don't need print resolution.

The logo appears on the reports you send customers, on invoices and in the app header. If you don't upload one, the first two letters of your workshop name are shown instead.

Opening hours#

For each day of the week you choose Open or Closed and set the time ranges. You can add up to three: two model a lunch break (say 9:00–13:00 and 15:00–19:00), the third covers evening opening.

The Copy Mon → Tue-Fri button replicates Monday's hours across the weekdays. It's the quickest way to set up a normal week: get Monday right, copy it, then adjust only Saturday and Sunday.

Until you have saved any hours at all, CrankPal falls back to 8:00–19:00 every day inside the workshop app only, so the calendar isn't unusable on your first login: you and your team can book appointments straight away. That's a safety net, not a configuration: as soon as you save your real hours, only what you entered counts.

The fallback does not extend to online booking. Until you save your hours, your public page offers no slots at all and customers can't book themselves: with no hours on file the system has no way of knowing when you're open, and it shouldn't guess — it would offer appointments on Sundays too. A notice at the top of the workshop app reminds you until it's sorted; save your hours and online booking reopens on its own, with no further steps.

Don't confuse the two cases: never having saved your hours is different from having saved "closed" on every day. The second is your own choice, legitimate and respected — online booking stays on and simply shows no slots — and it raises no notice.

Operating parameters#

Four fields and three switches that govern the everyday work.

  • Parts auto-approval threshold (€) — the amount below which a part added mid-job doesn't need the customer's go-ahead. Above the threshold an approval request goes out. This single number decides how many times a day you stop work to make a phone call: see Parts approvals. At check-in you can agree a different threshold with an individual customer, and that work order uses theirs.
  • Max check-ins per 15-minute slot — how many customers you can take in at once. The calendar shows slots that hit this number as full, and won't accept any more.
  • Currency and Timezone — used for amounts and for working out times. Only change them if you operate outside Italy.
  • Predictive maintenance — automatically warns the customer when a component on their bike is approaching replacement, inviting them to book. The estimate starts from distance ridden, weather and manufacturer intervals, and gets sharper as you record jobs in your workshop.
  • Timer-start reminder — when someone opens a work order with no timer running, they're asked whether they want to start one. The prompt can always be dismissed.
  • Mandatory two-step verification — forces a second factor (authenticator app, emailed code or passkey) on every member of workshop staff.

Check-in acceptance terms#

The text the customer sees when they hand over the bike. CrankPal provides a default, already consistent with the auto-approval threshold you set: leave it alone and that's what's used.

You can rewrite it for your workshop — storage conditions, collection times, liability. Each edit bumps the version of the terms and applies to new check-ins: the ones already recorded stay tied to the version the customer had in front of them when they accepted. If you change your mind, Restore default brings the CrankPal text back.

Common problems#

I filled in my address but I'm not on the website map

The address and the coordinates are two separate things. Go to the map position card, press «Find coordinates from address» and save. The line below the fields tells you at a glance whether you're visible.

A customer says there are no free slots, but I'm open

Three possible causes, in order of likelihood: that day is marked closed in your hours; the time they want falls in the lunch gap between two ranges; or that slot has already hit the maximum number of check-ins per 15 minutes. The first two are fixed in the hours, the third in the operating parameters.

I changed the acceptance terms — do they apply to bikes already in the shop?

No. Check-ins already recorded stay tied to the version of the terms the customer accepted at the time. The new text applies from the next check-in onwards.

My logo is rejected

It's over 200 KB. Resize the image or export it with stronger compression: it is displayed small in the app and on documents anyway.

I lost my changes when I switched tabs

The page warns you when you leave with unsaved changes and offers to save them. If you chose to discard them, the values go back to the last save: there's no undo.

With the profile done, the next two steps are your staff and your service catalog.