Tips and troubleshooting
ApptiveTeams doesn't report configuration errors — it simply omits anything faulty. A missing tab is almost always a Key or required-field problem.
The app doesn't show a team
Four causes are possible:
- The Space doesn't have the category
apptiveTeams. → Setting up the Team Space - The signed-in person isn't a member of the Space. → Invite people
- The Space is not on the Pro plan. It then appears in the list but cannot be opened.
- The
versionfield in theconfigGrid is higher than the installed app knows. The app then asks for an update.
The bottom tab bar doesn't appear
The navigation bar only shows once there are two valid tabs. Check that at least two rows in the tabs Grid have all required fields filled in — a row with a missing icon doesn't count.
A tab, tile, or card is missing
| Check | Why |
|---|---|
| Are all required fields filled in? | Rows with gaps are skipped |
| Are field Keys spelled exactly right? | Case matters |
For tabs: is type correct? | Valid values are TilesGrid, CardList, WebView, and TimeTracking |
For tiles/cards: is actionType correct? | An unknown value makes the row unusable. internalFormLink is also unknown to older app versions |
| Is a filtered View linked? | The filter might be hiding the row |
Logo or color isn't applied
In the config Grid, both logo and primaryColor must be filled in — if one is missing, the entire row is ignored and the app starts with no branding at all.
The color must be a hex value like #1565C0. Also keep in mind that only the first row of the Grid is evaluated.
Icons aren't displayed
Tab and tile icons must be SVG files — a PNG or JPG won't render. Since the app tints the icons, single-color SVGs without their own fill colors work best.
A WebView tab stays blank
Some websites block being displayed in embedded views. Open the address in the device's browser for comparison. If it opens there but not in the app, the target page is blocking embedding — in that case, a tile with externalLink is the only option.
Changes don't show up in the app
Tap the refresh icon in the top right, or restart the app. The configuration isn't continuously reloaded.
"Created by" doesn't show the right person
The tile or card is probably using externalLink. Only internalLink passes the signed-in person along to the form. → Tiles and cards