Capture screenshots automatically
Connect your product's dashboard and Fern signs in with a test account, takes screenshots and adds them to its drafts, with an arrow on the control a step names.
This integration is in beta. Owners and admins can connect it.
Connect your dashboard
In Integrations, connect Dashboard. Give it a name, the address Fern should start from, and the login steps, written as you would explain them to a new teammate, with the exact button and field labels.
Write the steps out in full, including any password, email link or code step. For example:
1. Click Sign in
2. Enter the email and password of the test account
3. If asked for a 2FA code, click Use a backup code and enter it
4. Click ContinueUse a test account that can see every page you want in your docs, not a personal or admin account. We encrypt the login steps, and after a successful sign-in Fern keeps the session for next time. Change the login steps and Fern signs in again from scratch. You can change the login steps or disconnect the dashboard from the connection's page.
If your app signs in with an email link or a code, turn on Create a Fern login email. Ferndesk creates an email address for the connection, shown on its page as Login email. Use it as the test account's email, and Fern reads the link or code from the emails it receives.
Several logins or roles
Add one connection per login, for example "Admin portal (admin)" and "App (member)", or one for staging and one for production. Fern knows each connection by its name, so say which one to use: "Take screenshots of the billing settings from Admin portal (admin)".
Ask for screenshots
Ask in any task, for example "Update the API keys article with fresh screenshots". Fern captures web pages in a desktop browser window. It cannot open desktop or mobile apps, so attach those screenshots to the task yourself. See Ask Fern to write or update articles.
Move or remove Fern's arrows
Fern's arrow is a separate shape on the image. Open the screenshot in the image editor to move or delete it, crop the image or blur something. Fern also keeps each screenshot without the arrow, so you can ask Fern in the task to use that one instead. See Write and edit articles.
When screenshots show the old screen
Fern takes screenshots from the address you connected, at the moment it works. A draft from a merged pull request often runs before your release reaches that address, so its screenshots can show the old screen. Once the release is live, ask Fern in the same task to retake them. If you have a staging site that deploys on merge, connect it as well and name it in your request.
If Fern cannot sign in, make the login steps more exact: the real button text, the field labels, and any extra step such as a cookie banner.