Modules

Create an app and arrange its menu in Studio

Build a custom module from a short wizard without the Agent, then choose where it sits in the sidebar, add sub pages, and save a filtered view as a menu row.

Studio has two ways to start a custom module. You can describe it to the Agent, or you can build it yourself with the New app wizard. The wizard needs no Agent. Building a custom module needs Scale or Enterprise, as described in Studio: change modules and build your own.

The New app wizard

On the Studio home, select New app, beside Your modules. The button shows only to people who can build modules. The wizard has four steps, with the progress shown as Step 1 of 4 and so on.

  1. Name and icon. Give the app a name of up to 60 characters, with at least one letter or digit, and choose an icon. For example: Vehicle repairs.
  2. Where it sits. Choose the sidebar section. You can move it later, hide it from the menu, or add sub pages in Studio.
  3. What it needs. Choose what the app needs. Each choice adds real fields and behavior: Stages with a board. Records move through stages you name, on a board and in a list. Name the stages one per line, within the limits the wizard shows. An assignee. Each record has a person responsible. A customer contact. Each record links to one of your contacts. An amount. A money field for a cost, a fee, or a price. You choose what to call it. Dates with a calendar. A start date and a due date, and a calendar of them. Tags. Label records with tags you choose, separated by commas. Notes and activity. A notes field. Every record keeps its activity: who changed what, and when. Line items. Items with a quantity and a price on each record, and their total.
  4. Preview. Shows the section, the fields, the stages, and the sub pages the app will have.

Nothing exists until you select Create app. The app then appears in your sidebar, and people see it only if they may open it. From there you can choose Customize in Studio or Open the app. Undo takes the app back, and you can find it under recently deleted modules if you want it again. See Delete and restore a custom module.

If an app with that name already exists, the new one is stored under a numbered key and keeps the name you typed.

The menu

Open a module in Studio and use Menu to decide how it appears in the sidebar.

  • Show in the menu turns the module's row on or off. A row left out of the menu still opens by its address, and who may open it does not change. The Dashboard always shows, because it is where everyone lands.
  • Sub pages lists the module's sub pages. Rename a page, move it up or down, and show it in or hide it from the menu. A hidden sub page still opens.

Add a sub page

Select Add a sub page, or New sub page when there are none. A sub page opens the same records as its module, and you choose how:

  • Name. What the row is called in the menu.
  • Records. All of them, or one record type.
  • View. It opens in its default view, or in Table, Grid, Board, Calendar, Pivot, Graph, or Gantt. See Pivot, Graph, and Gantt views.
  • Filter. Select Add a filter and choose a field. A choice field or a yes or no field can filter the page, for example only records where Status is Open. Select Remove filter to take it away.

This is how you save a filtered view as a menu row. People see only the records they may open, so a sub page never shows more than the module does.

Sub pages, like the rest of a Studio change, are reviewed before they are applied. Nothing reaches your team until you apply it.

Troubleshooting

I do not see New app

It shows only to people who can build modules in Studio, on a plan that includes custom modules.

The wizard says it cannot build an app from my choices

Check the message under each choice. Common causes are a name with no letter or digit, a number of stages outside the limits shown, no tags, or an amount name that another field already uses.