Organizations and workspaces

Your organization is your company or team in JamFrame. Workspaces split it into separate areas, for example one per brand or one per client. This page explains both and shows how to manage workspaces.

Your organization

• It has one plan, one pool of render credits and one pool of AI credits. Every workspace uses the same pools.
• You get one when you sign up, with one workspace in it. You are its owner.
• Each person belongs to one organization. To work with a team, accept their invite. See Accept an invite.
• The people in it, and what each one can do, are on the Organization page. See Invite your team and set roles.

To rename the organization (owners and admins): in the sidebar, click Organization, click Rename next to the title, type the new name, and click Save.

What a workspace holds

Each workspace has its own:

• Templates
• Brand library (logos, images, fonts and colors)
• Renders, listed on the Renders page
• API keys. A key works only in its own workspace.
• Webhooks
• Dynamic URLs and forms
• Workflows
• Signing key for signed URLs

Workspaces don’t share any of these. What they share is the organization’s credits, and the ready-made templates that every workspace can start from.

Switch workspace

At the top of the sidebar, pick a workspace from the list. The app opens the Templates page of that workspace.

If you can reach only one workspace, the sidebar shows its name under Workspace instead of a list. “(viewer)” after a name means you can look at that workspace but not change it.

Create a workspace

Owners and admins can create workspaces.

1. In the sidebar, click Organization.
2. Under Workspaces, type a name in New workspace name.
3. Click Create workspace.

The new workspace shows in the table and in the sidebar’s list. How many workspaces you can have depends on your plan (see pricing). The number next to Workspaces shows how many you use. When you reach the limit, the app shows Plan limit reached.

Each workspace has a number, shown in the ID column, such as #2. Mention it when you contact support.

Rename a workspace

1. On the Organization page, find the workspace under Workspaces.
2. Click Rename in its row.
3. Type the new name and click Save, or press Enter. Press Esc to cancel.

Give people access

Owners and admins reach every workspace. Members reach only the workspaces they are given. To give access, click Invite in the workspace’s row to invite someone straight into it, or click Settings and use Member access. See Invite your team and set roles.

Cap a workspace’s render credits

By default every workspace uses the organization’s credits freely. A cap limits how many render credits one workspace can use in each billing period, so one client or team can’t use up everyone’s credits.

1. On the Organization page, click Settings in the workspace’s row.
2. Under Render credit cap, type the most credits this workspace may use each billing period.
3. Click Save cap.

To remove the cap, empty the box and click Save cap. The workspace then draws from the shared pool again.

Good to know:

• The cap counts every credit the workspace used since the current billing period started, including credits used before you set the cap.
• A cap is a ceiling, not a reservation. Caps can add up to more than your plan, and the organization can run out before a workspace reaches its cap.
• A cap of 0 stops all renders in that workspace.
• Caps apply to render credits only. AI credits aren’t capped per workspace.
• The count starts again at 0 when the next billing period starts.

When a workspace reaches its cap

Renders in that workspace stop until the next billing period. Other workspaces keep working.

• Test renders show an “Out of render credits” message.
• The API answers 402 WORKSPACE_QUOTA_EXCEEDED.
• Dynamic URLs and forms answer 402 CREDITS_EXHAUSTED for new images. Images a dynamic URL already made and still has in its cache keep showing.
• Workflow runs stop, and the rows that are left are skipped.

To keep going, raise or remove the cap, or wait for the next billing period. Nothing is charged for renders that were refused.

See how much of the cap is used

• Sidebar: “Cap 40 / 500” under the workspace’s name, and a Workspace cap bar in the credits card at the bottom.
• Organization page: the Cap column shows used and limit for each workspace.
• Settings: “Used 40 of 500 credits this cycle.”

Related

• Invite your team and set roles
• Credits
• Pricing