Automations

What you'll achieve

By the end of this guide you have a working automation. In the app it is called a flow.

A flow starts when something happens, such as a new product arriving from your store. Then it runs a chain of steps, called actions, that generate images, send them to you for approval, and upload the approved ones back to your store.

Before you start

• A connected store, because every trigger except Manual Trigger listens to your store. See Store connection.
• Enough credits. The builder shows an estimate of the credits each run uses.
• Access to the Flow page. If Flow is not in your left sidebar, it is not available for your workspace or plan.

Open the Flow page

1. In the left sidebar, click Flow.
2. Suggested flows shows ready-made flows. My flows lists the flows you created.
3. If your store is connected, a chip near the top reads Webhooks active or Webhooks reconnected when everything is working. If it reads Webhook issue, click it to re-check. Until it is fixed, store-triggered flows may not start.

Option A: Start from a suggested flow

1. On Suggested flows, pick a card. Each shows its steps:
2. Launch a collection: Collection Created, Generate, Email Approval, Upload to Store.
3. Photo → Approve → Upload: Product Created, Generate, Email Approval, Upload to Store.
4. Video Showcase: Product Created, Generate, Generate Video, Upload.
5. Hi-res product shots: Product Created, Generate, Upscale, Upload to Store.
6. Click Use template. The builder opens with the steps already in place.
7. Continue with "Choose what starts the flow" and the steps after it to adjust the details.

Option B: Build a flow from scratch

1. On the Flow page, click New Automation. If you have no flows yet, click Create Automation.
2. The builder opens with the name Untitled Automation. Click the name field at the top and type a name, for example "New product photos".

A new flow is not stored until you click Save (see "Name, label, and save").

Choose what starts the flow

1. On the canvas, click Choose a trigger. The properties panel opens on the right.
2. Under Trigger types, open the menu and pick one or more triggers. The flow starts when any of them happens.
3. Product Created: fires when a new product is added to your store.
4. Product Updated: fires when an existing product is modified.
5. Collection Created: fires when a new Shopify collection is created. It runs for the products currently in that collection.
6. Manual Trigger: you start the flow yourself on products you choose. It runs on its own and can't be combined with store triggers.
7. Under Configuration, check that Store connection says Connected. If it says No store connected, click Connect one.

If your store can't send product events, the panel says so and only Manual Trigger is available.

Narrow it down with filters

For Product Created and Product Updated, these optional filters appear. Leave them empty to run on every product.

1. Trigger on changes to (Product Updated only): pick from Title, Description, Tags, Images, or Category. The flow then fires only when a selected field changes. A product Epox hasn't imported yet needs one update first. That first update doesn't start the flow, but every update after it does.
2. Filter by categories: type or pick categories. Leave it on All categories to match everything.
3. Filter by tags: type or pick tags. Leave it on All tags to match everything.

Add the actions

1. Under the trigger, click Add action.
2. Under Choose an action, pick one. The steps run top to bottom.
3. Generate Image: generates images from a template, pack, or custom prompt.
4. Edit Image: applies edits to generated images.
5. Generate Video: creates a video from generated images.
6. Upload to Store: pushes generated assets back to your store.
7. Email Approval: sends an approval email. Approved images continue to the next step.
8. Repeat to add more actions. Drag a step to reorder it.
9. Click a step to open its settings on the right. Under Action details you can change its Action type.

The estimated cost appears under the list, for example ≈ 4 credits / run. The ≈ means some steps depend on how many products run, so the real cost may be higher.

Set up Generate Image

1. Click the Generate Image step.
2. Pick an image model at the top.
3. Choose a template or a pack to start from. A pack applies several templates, and you can click each one to see its settings.
4. Under the settings grid, add or change generation settings.
5. Under Prompt, add extra details in Add additional prompt details....
6. Under output settings, choose Aspect Ratio, resolution, and the number of variants per product. Each variant is another image per product and uses more credits.

Set up Edit Image

1. Click the Edit Image step.
2. Under Source Steps, select which earlier steps' outputs to edit.
3. Choose an edit template. The edit applies to all images from the selected source steps.

Set up Generate Video

1. Click the Generate Video step.
2. Pick a video model.
3. Under Source Steps, select which earlier steps' images to animate.
4. Choose a template if you want one.
5. Under Video Prompt, describe the motion you want.
6. Adjust Output Settings.

Set up Email Approval

1. Click the Email Approval step.
2. Under Source Steps, select which steps' outputs you want to review.
3. Under Recipient Email, enter who reviews. By default it is the workspace owner's email. Click Add recipient to add more people.
4. Optional: back on the Flow page, set Email Batch Window to control how long Epox waits before sending one combined email. Choose Immediately, 5 min, 10 min, 20 min, 30 min, 1 hour, or Daily.

Reviewers open the link in the email without logging in. They can:

• Remove an image with the red ✕ on its tile, or click it again to undo.
• Click Reject all, optionally add a note under What should be improved? (optional), and click Reject & cancel run. This cancels the run and nothing is uploaded.
• Click the main button to finish. It reads Continue when an upload step follows, Approve when it doesn't, or Submit rejections if every image was removed.

Set up Upload to Store

1. Click the Upload to Store step.
2. Under Source Steps, select which steps' outputs to upload.
3. Tick Draft products only to update only products that are still drafts in your store.
4. Under Gallery position, choose where the new images go: Last (append), 1st (First), 2nd, 3rd, 4th, 5th, or Custom… to enter your own number.

Name, label, and save

1. Click a blank area of the canvas to see Flow details.
2. Edit the Name, add a description (What does this flow do?), and pick a Thumbnail with Add thumbnail.
3. Under Labels, type a label and press Enter to group your flows. You can add up to 12. Run history can be filtered by label.
4. Click Save in the top bar. You return to the Flow page.

The builder asks for a name and at least one trigger before it saves.

Test the flow

1. On the Flow page, click your flow's card to open it, or use the menu and click Edit.
2. Click Test run in the top bar.
3. In Select Product for Test Run, choose one product. For a collection trigger, Select Products for Test Run lets you choose several.
4. Click Trigger Test Run.
5. The canvas shows each step's progress. If the flow has Email Approval, the run pauses at Awaiting Approval until a reviewer responds.

Edits to an existing flow save automatically. The top bar shows Saving... and then Saved, or Not saved if something went wrong.

Turn a flow on or off and manage it

1. On a flow's card, click the power button to switch it between Active and Disabled. A disabled flow keeps all its settings.
2. Drag a card by its handle to reorder your flows.
3. Open the card's menu to Edit or Delete the flow.

Monitor runs

1. Open a flow and click the clock button on the canvas to open Run History. Click a run to see each step's state.
2. A run shows one of these statuses: Pending, Running, Awaiting Approval, Retrying, Completed, Failed, Cancelled, or Imported.
3. To stop a run in progress, open it and click Cancel run.
4. To try a finished run again, open it and click Re-run this product (or Re-run these products), then Confirm re-run.
5. For all flows at once, scroll to Flow run history on the Flow page. Use All labels to filter by label.

Common setups

1. Photos for every new product, reviewed before they go live: trigger Product Created, then Generate Image, Email Approval, Upload to Store with Draft products only ticked.
2. Refresh images when a product photo changes: trigger Product Updated with Trigger on changes to set to Images, then Generate Image, Email Approval, Upload to Store.
3. Launch a new collection: trigger Collection Created, then Generate Image, Email Approval, Upload to Store. Or start from the Launch a collection suggested flow.
4. Generate on demand: trigger Manual Trigger, then Generate Image. Run it with Test run whenever you choose products.
5. Add a video to new products: trigger Product Created, Generate Image, Generate Video with Source Steps set to the Generate Image step, Upload to Store.

Check your result

1. On the Flow page, your flow shows Active and its steps, such as Product Created → Generate → Approval → Upload.
2. After the trigger happens, or after a Test run, the card shows the latest run.
3. If you used Email Approval, check that the reviewer received the email.
4. After approval, open the product in your store and confirm the images appear in the gallery position you chose.

Next steps

• Store connection
• Templates