Sundry Works Help · Settings

Configuring Sundry Works

Where everything plugs in: your social accounts, your website, your AI service, and where the catalogue lives.

What it's for

Everything that plugs into something else, in one place. Press Settings at the foot of the rail and its sections run along the top of the page: Settings first, then Instagram & Facebook, Threads, Bluesky, Pinterest, Website and AI writer.

The first page, Settings itself, is about the catalogue and the service rather than about anywhere your paintings go: the backup, the folder the catalogue lives in, the thumbnails, the Sundry Works service card, the comments page, light or dark, and the optional tabs. At the top is a hot-air balloon for every connection, each in its own colour - flying when it is set up, waiting on the ground when it is not - and pressing one takes you to its page.

Every connection page is laid out the same way, so learning one is learning all of them. At the top, its balloon, what it gets you and roughly how long it takes to set up, with a note in the corner saying how far along you are. Then "How it goes": the steps in order, each one ticked as the card beside it shows it done, and the one you are on ringed. The card itself is where the buttons are, the same buttons as before.

Every card says one thing and shows its buttons. The longer explanation - where a key is kept, why Load paintings is not a repair, what the timer does with your sign-ins - is behind the small More about this at the foot of the card, for when you want it.

All of this used to be one page of thirteen cards, and before that it sat halfway down the Business tab. Nothing about connecting changed when it was split up - only how much there is to read past to find the one you want.

You do not need any of it to catalogue a painting. Set a connection up on the day you want the thing it does.

Light or dark

Sundry Works has always been dark. There is a light one now, and the switch is on the Settings page, in the left-hand column. It is the logo's own colours the other way up - aged paper, the deep navy of the lettering, the same brass and teal and terracotta that are already in the little painted details. The menu bars stay dark either way, because the logo is cream inside a dark frame and this is the same arrangement.

It is remembered on this device only, so the phone in a bright studio and the laptop in the evening can be set differently. That also means a new browser, or one whose site data has been cleared, starts on dark again - one press to change back.

Nothing you make changes. A card, a label, a reel, a certificate or a business card carries the colours it will be printed and posted in, and those belong to the painting rather than to the window it was made in.

If the light one looks faint anywhere, say so - it was measured surface by surface rather than eyeballed, and anything that reads badly is a number that can be moved.

Stories and captions

Plenty of artists never write either one. The Stories and captions card, on the AI writer page under the AI Services card, has a switch for each: Stories, the long piece written from the artwork that fills the card, the back label and the reel, and Captions, the short version cut from a story, for posts. Both ship on, so an existing catalogue opens exactly as it always has.

Turn one off and everything built from it disappears - its panel on the Story tab, its tick on the Paintings list, and the places it was offered on the Post tab. Nothing already written is deleted. Switch it back on and all of it returns exactly as it was.

Turn both off and a box called "About this art", on the Story tab, takes over as the source: type a few sentences there and they fill the card, the back label, the reel, a post and your website page, and the social captions are written from it too. With only one switch on, that same box is what an older painting falls back to if it has no words of its own from the writer still switched on.

The four connections

Instagram and Facebook are one connection wearing two names, and it is the longest to set up. Threads is its own connection again, and needs the Instagram and Facebook one working first. Bluesky is the quick one: a handle and an app password, nothing to register.

Pinterest is a fifth, and the odd one out: nothing to register and nothing to paste, but its sign-in lives on the Sundry Works service, so it needs the service token first - and a board chosen after you connect.

Each has a page of its own in Settings, and a guide of its own in this book - Instagram & Facebook, Threads, Bluesky and Pinterest - with every step and what to do when one of them refuses.

All four are signed in to the same way on a laptop or the phone. Pressing Connect takes the page off to Meta, and Sundry Works loads again a minute later with it done. Bluesky has no sign-in trip to make, so it connects where you are.

Signing in, and what it costs

This is worth one honest paragraph, because it changed something that used to be promised the other way.

Signing in to Facebook means swapping a code for a key, and that swap needs your App Secret. The old Windows program kept the secret in the Windows keychain and never sent it anywhere. A browser has no such place, so the Sundry Works service holds a copy - there is no way round it, because Meta offers no secret-free way to do the swap.

Before this, the service held a key that could post as you but not the secret that makes fresh ones, so disconnecting genuinely locked it out. That is still true, and it is why disconnecting deletes the secret as well as the key. Nothing on the server can let itself back in afterwards. The price is that reconnecting means pasting the secret in again, and the card says so at the time.

It also buys something, and from 1.74.0 it genuinely does it. An Instagram and Facebook connection lasts sixty days and used to be renewed only by the Windows program, so two months without opening it would have stopped posting with nothing saying why. The scheduler renews it itself now: it acts in the three weeks before a connection would lapse, and it does that whether or not anything is queued.

One thing is left over from the Windows program. A connection made there kept the key that does the renewing on that computer, on purpose, so the scheduler cannot renew it. Press Reconnect on the Instagram & Facebook page once and the scheduler holds what it needs and keeps it alive from then on.

Nothing breaks while you get round to it - the connection you have carries on working until the day it would have lapsed.

Bluesky is not part of any of this. Its app password is used once to sign in and is never kept - only the session it produced. Revoking it in Bluesky is the end of it.

One address has to be added in the Meta dashboard for this to work: https://sundry.works/api/connect.php, in both the Instagram and Facebook app and the Threads one. The step-by-step setup on each connection page has you add it.

Publishing to your website

The card called "Publish to your website" puts your catalogue on your own WordPress site - one page per painting, with the story, the picture, the medium, the size, the price and whether it is still for sale. It needs three things once: the address of your site, the WordPress user the password belongs to, and an application password.

An application password is not the login you type yourself. Make one in WordPress under Users, then Profile, then Application Passwords. It comes as six short blocks. Paste it in and press Save - and note that typing in the boxes does not save anything on its own, which the badge above them will tell you. Once saved, the heading changes to name the site you are publishing to, so you can always see where the next run is going.

Saving checks the password against your site there and then, and says "Saved, and the sign-in works" when it does. If WordPress will not accept it, it says so and does not keep it - which is the moment to find out, rather than halfway through a publish. If your site cannot be reached at the time, it saves anyway and tells you it could not check.

Then there are two buttons, and only one of them sends anything. Check first reads the whole catalogue and prints a report - every painting, its address on the site, and anything worth looking at, like a painting with no story or no picture. It sends nothing at all, so it is always safe to press, and it is the one to press first. Publish is the one that writes, and it writes the moment you press it. That is why Check first is the filled button and Publish is outlined.

The most useful part of that report is the list of what a publish would actually change. Edit one story, press Check first, and it names that painting and says the story is what differs - so you know before you send anything that one page will change and the other fifty-nine will not. It counts only the words and facts that print on the page: recording a sale, writing yourself a note, or rewriting a draft you did not choose will never make a painting look like it needs republishing.

Paintings published before this was added cannot be compared - the publisher had no record of what it sent - and the report says so rather than guessing. It sorts itself out the first time you publish.

After an update that changes what counts as a change, the first Check first can name every painting at once. That is the update catching up rather than sixty things going wrong: the publisher is comparing against records written before the new rule existed. Publish once and it settles down again.

The report names the gallery each painting is going to, on every line. If you have moved one to a different gallery since it was last published it shows both, as "Umberdawn -> Nickeldusk", so you can see the move before you send it. Every run finishes with a count of your paintings by gallery, which is the quickest way to notice that a gallery you have just set up holds six paintings when you filed seven.

Moving a painting to a different gallery counts as a change, so Publish sends it and its page on the website moves with it. The gallery on the site always follows the one in Sundry Works and there is nothing to file by hand over there. A gallery you have only just created is made on the website the first time a painting in it is published.

Publish only sends the paintings that changed. If you edited one story, it sends one painting and tells you: "1 painting(s) sent, 59 unchanged and skipped". If nothing has changed it sends nothing at all and does not even contact the site. That makes an everyday publish a second or two rather than a couple of minutes.

Publish leaves live pages live and brings them up to date. A brand new painting goes up published, so pressing Publish puts it on the website. A page you have parked as a draft in WordPress on purpose stays parked. There is no way to unpublish from this card - that is deliberate, because it is the kind of thing you would only ever do by accident.

A painting can be kept off the website altogether. On the Paintings tab, under Notes, there is a tick called "Keep this painting off the website" - for a commission still with its buyer, a study kept for the record, anything not for showing. Neither button will send it, and "Send everything" does not override it. Check first gives them their own list at the foot of the report, headed "Kept off the website", so you can see at a glance which paintings are being held back.

That tick does not take a page down. A painting already on your site that you tick afterwards keeps the page it has, and the report marks it - "already has a page there; it stays until you delete it in WordPress". Taking a live page off the internet is a thing to do on your site, deliberately, rather than a thing a tick does quietly.

New paintings used to arrive as drafts for you to approve on the site, which meant pressing Publish and finding nothing there. Check first is the approving step now, and it shows you every page before one of them is sent.

Check first also tells you when a painting has no alt text or no description. Both are a sentence written for that one painting, both are used by search engines rather than shown on the page, and nothing else would ever tell you one was missing. Without alt text the picture is invisible to Google Images. Without a description, the site falls back to your Instagram caption, which is about three times the length Google will print. There is nowhere in the app to write either one yet.

Underneath, a pane shows what the run is doing as it goes, and it stays there afterwards so you can read it. If you switch tabs mid-run, the run carries on and the report is still there when you come back.

Above that pane, a single line says what is happening right now - reading the catalogue and how far through it is, working out what has changed, reading the pages already on your site, then sending each painting by name. That line is thrown away when the run ends; the report is what stays.

Both buttons take a while, and a minute or more is normal. It is not your website: neither button has contacted it yet at that stage. Both read the whole catalogue first, photographs included, and that is a download rather than a read off your own disk. The line above the pane is counting that download.

Press Check first and read the report before you ever press Publish. It costs nothing and it is the only way to see what a run is about to do.

When the website card needs a hand

If a run stops early saying WordPress did not accept the sign-in, nothing was sent and nothing on the site was touched. Make a fresh application password in WordPress under Users, then Profile, then Application Passwords, and paste it in again. Check the user name on the card matches the WordPress user you made it under. A password can also be revoked from that same screen, which looks exactly like a wrong one from here.

The publishing is the app's own code, so there is no separate program to find and no folder to point at. There used to be, and the card used to say "Publisher not found" or ask you to restart after an update. Neither can happen now.

It works the same from the phone. It is the same catalogue and the same record of what was sent, so it does not matter which device you press it from. The password is the one thing that does not travel: it is kept in the browser you paste it into, so each phone or browser asks for it once.

AI Services

This is where you choose which service writes your stories and paste that service's API key. Pick a provider from the Story provider list, then paste its key below. The key is kept separate from your business and painting records, and never leaves except in requests to the provider you pick.

It is kept on the Sundry Works service - the same server that does your scheduled posting - because a browser has no safe place of its own to keep a key. That is why the AI writer page needs the service token first.

There are two, and both of them look at the painting while they write. Google (Gemini) is the default and has a generous free tier, so it is a good place to start - get a free key at aistudio.google.com. Anthropic (Claude) gives the best writing quality and is paid, though not by much: at one or two paintings a month, ten dollars of credit lasts years rather than months.

Groq was a third choice until 1.66 and has been taken out. It could not see the painting - the one model it had that could look at a picture was retired from its free tier - so it wrote from the title and the facts you typed while the app still made you attach an image. If Groq was the one you had picked, you are on Gemini now and there is nothing to do about it.

Under the provider list is a line about what that service does with what you send. It is worth reading, because the note above it is about your key, not your painting - and the painting is the thing that actually gets sent. In short: Google's free tier may use it to improve their products and human reviewers may see it, their paid tier is not used that way, and in the UK, the EU and Switzerland the paid terms apply to both; Anthropic does not train on anything sent through its API on any tier, and deletes paintings once the request has been answered.

Use Save to store a key, Test key to check it works, and Clear to remove it. Below that, choose which model writes your stories - you can switch provider or model anytime, with nothing to rebuild. If a model is ever renamed, the one you picked stays picked.

The Sundry Works service

This card is what connects this browser to the Sundry Works service. It takes your token - eight characters, a dot, then sixty-four more - and once it is in, stories, posting and your connections all work here.

It also shows how many stories today has used against the daily limit. That limit is there because the key is on a server now: anyone holding the token could spend against your account, and a ceiling turns a leaked token from an expensive problem into an annoying one.

"Show my token" reads it back out of this browser, which is how you set up another one. Nothing reads it on its own - it appears when you press the button and goes again when you press Hide.

Disconnect removes the token from this browser. Be aware it is one token for two jobs - disconnecting here stops scheduled posting from this browser as well.

The token is kept in that browser alone and deliberately not in your Dropbox folder, so it never travels into a backup or onto a device you did not put it on. That is why each new phone or browser asks for it once.

Where your catalogue lives

Your catalogue lives in one of two places, and the Catalogue folder card on the Settings page says which. Most artists keep it on the Sundry Works service, in an account of their own on sundry.works. The other choice is your own Dropbox, in one folder called Apps/Sundry Works that the app can see and nothing else.

When it sits in Dropbox, Dropbox keeps its own history of every file, so a painting edited by mistake can be put back, and every device you sign in on reads and writes that same folder.

"Use a different store…" on that card swaps between the two. It deletes nothing either way: both catalogues stay exactly where they are, and the page reloads and asks which one to use.

The app remembers what it has already read, so opening it a second time and opening a painting you have looked at before are both quicker. It only trusts that memory while this device holds the catalogue, because that is exactly when no other device can be changing it. The moment the other one has the catalogue, the memory is ignored and everything is read fresh. You never have to think about it, and it can never show you an older version of your own work. Choosing a different store clears it.

Either way the app needs an internet connection to open the catalogue. It is a website, and it reads the service or Dropbox over the internet rather than off your own disk.

Backup

There is a card called Backup at the top of the Settings page's right-hand column, and the Paintings tab carries it too, on the What's next board - as a fifth card when a backup is due, and as one grey line saying how long ago when it is not. It is in two places on purpose. Nobody goes looking for a backup on a good day - they go looking on the morning a painting is not where they left it, and a settings page is the last thing anybody wants to be searching through then.

It says when your last backup was taken, in so many words, and turns red here if you have never taken one or if the last one is over a month old - which is also when the Paintings tab starts showing it as a card to do. That date is kept with the catalogue rather than on one machine, so the phone and the laptop give the same answer about the same paintings.

The backup is the zip that Export all writes. That is true wherever your catalogue lives - on the Sundry Works service or in your own Dropbox. If it is in Dropbox then Dropbox keeps its own file history as well, which is a real second copy and worth having; it is not the thing to rely on, and an artist on the service has none of it.

One thing a backup only does if you move it: keep a copy somewhere other than the device that took it. The zip lands wherever your browser saves downloads, and it goes when that disk goes. A memory stick, a second drive, or an email to yourself is the whole of what is needed.

Taking one costs a press and a minute. There is no schedule, no setting and nothing to switch on - which is deliberate, but it does mean the only thing that takes a backup is you pressing the button.

Loading, exporting, and restoring

What each of the buttons does, in full:

• Export all - saves the whole catalogue as a single dated zip. Everything: every painting, its photo, its progress photos, and every setting you have made - your logo, your font, the card frame, the business profile, the pricing anchors, the story prompts. About 36MB for sixty paintings. This is your backup, and it is also a fixed snapshot you can keep on a memory stick or email to yourself.
• Unzip it and you have your catalogue as an ordinary folder, which is the same shape the app keeps it in. Nothing about it needs this app to open it - the paintings are plain JPEGs and the records are plain text. To bring one back into the app, use Restore from file.
• Restore from file - loads one back in. It shows you what the file holds and waits for a second click before writing anything, because a restore overwrites your business profile if the file carries one. It merges rather than wiping, so anything already here is kept or overwritten by the newer file. It takes the zip, and it still takes every older backup, including the single-file ones this app used to write and the "everything" export from the older Claude.ai version.
• Load paintings - reads every painting in the catalogue and rebuilds the list from what is there. It is on the Catalogue folder card when the catalogue is on the service. Press it any time the list looks out of step, or after a catalogue has been copied into your account from outside the app. It is a read, not a repair: nothing is thrown away.

The rest of the Help

Start here

• Getting started with Sundry Works - What Sundry Works does and how the tabs fit together.
• Using Sundry Works on your phone - Putting Sundry Works on your phone, beside the laptop or instead of it.

Your catalogue

• What's due and what's unfinished - Where the app opens: what to carry on with, what needs you, what's coming up.
• Cataloguing your paintings - Your catalog - add paintings and open the one you're working on.
• Reviewing everything one painting makes - Everything the open painting makes, on one page, with the one decision each needs.
• How to price a painting consistently - Work out a consistent price for the open painting.
• Tracking what sold and who bought it - What sold, who took it home, and what it brought in.
• Story cards, show labels and a portfolio - More than one at a time: a whole show's story cards or labels, or a portfolio to send.

Making things from a painting

• Writing a story for a painting - Generate a written story for the painting and keep the best one.
• Making a printed card for a painting - Lay out the printed card for the painting.
• How to make a certificate of authenticity - A painting's two printed documents: its certificate, and the label for its back.
• Web-sized copies of a painting's photo - Export web-sized copies of the painting's photo.
• Branded posts of your paintings - Branded static posts for Instagram, Pinterest, and Facebook.
• Making a reel of a painting - Build the vertical reel frame and video for social media.
• Designing an artist's business card - The card you hand out, laid out down to the last millimetre.
• Making an artist bio sheet for a show - One page about you, to stand beside your work at a show.

Running the business

• Setting up your artist brand - Set up once: your identity, brand assets, and colours.
• An address book for galleries and collectors - Galleries, collectors and suppliers - what they bought, and when you last spoke.
• Checklists for shows and studio jobs - Reusable checklists for shows, errands, and anything you repeat.
• A calendar for shows and deadlines - Shows, deadlines, and events, with a countdown to each one.
• All your post comments in one list - What people said on your posts, from every platform, in one list.

Connections and setup

• Posting to Instagram and Facebook - Connect your accounts so you can post directly from Sundry Works.
• Posting your paintings to Threads - A second Meta connection, separate from Instagram and Facebook.
• Posting your paintings to Bluesky - The easiest connection of the four - a handle and an app password.
• Pinning your paintings to Pinterest - Pins with a link back to your page, sent by the Sundry Works service.
• What social media may do with your paintings - What each place you post to may do with your pictures, and what you can do about it.
• Scheduling posts to go out later - Line a post up now and let it go out later, with the app closed.
• Configuring Sundry Works - Where everything plugs in: your social accounts, your website, your AI service, and where the catalogue lives.