Troubleshooting
Diagnose common Solum account, search, document, inquiry, team, builder media, billing, and data accuracy issues.
Use this guide when something does not appear, does not submit, does not download, or does not behave the way a user expects.
Start with the simplest explanation first: wrong account, missing team membership, hidden permission-gated controls, missing catalog data, or a feature that is not available yet.
First questions
Collect these details before escalating:
| Detail | Why it helps |
|---|---|
| Page URL | Identifies the exact route and catalog item. |
| User email | Confirms account and invitation state. |
| Team name | Required for team, billing, builder, and role issues. |
| Role or expected role | Determines which controls should appear. |
| Missing control or exact error | Separates visibility problems from failed actions. |
| Browser/device | Useful for map, share, upload, and download issues. |
| Development/builder/community name | Required for catalog and public page issues. |
Account and sign-in
User cannot sign in
Check:
- Email is spelled correctly.
- Password is entered correctly.
- The user has an account for that email.
- The user is not trying to accept an invitation with a different email.
Password reset is not self-serve in the current product. Use the appropriate support path if the user cannot recover access.
User signed in but sees no teams
Likely causes:
- The user has not accepted an invitation.
- The invitation was sent to a different email.
- The user signed in with a personal or alternate email.
- The user has only a personal team, which is filtered out of the main dashboard list.
- The membership was removed.
Ask the user to confirm the account email from account settings, then compare it with the invited email.
Invitations
Invitation is expired or invalid
Ask an owner, authorized admin, or platform administrator to send a new invitation.
Invitation was sent to the wrong email
Do not ask the user to accept it from another account. Invitation acceptance is tied to the invited email address.
Create a new invitation for the correct email.
Accept button is missing
Check:
- Invitation status is pending.
- User is signed in.
- Signed-in email matches the invited email.
- Token is valid and not already accepted.
Explore search
No results
Try:
- Select Reset.
- Remove map area filter.
- Broaden price range.
- Remove home type or construction status.
- Search by city instead of a narrow neighborhood.
- Search by builder or community name.
- Confirm the market is covered by Solum.
Filter missing
| Missing filter | Explanation |
|---|---|
| Home type | The preload API did not return home type options. |
| Construction status | The preload API did not return status options. |
| Map area chip | No map area has been selected. |
| Load More | All matching results are loaded or there are no matches. |
Map shows fewer results than list
Map behavior depends on location and boundary data. If some developments do not have reliable location data, list search may be more complete than map browsing.
Public detail pages
Section is missing from the page
| Missing section | Likely reason |
|---|---|
| Gallery | No confirmed image assets are attached. |
| Floorplans | No structured floorplan data is attached. |
| Documents | No document assets are attached. |
| Builder website | No website URL is available. |
| Project details link | No project details URL is available. |
| Estimated completion | No completion date is available or it cannot be formatted. |
| Community description | No public description exists. |
Missing data does not always mean the builder does not have that information. It may mean Solum has not received or structured it yet.
Page not found
Check whether:
- The URL is correct.
- The development, builder, or community is published.
- The slug changed.
- The item was archived or removed.
Document downloads
Buyer sees locked documents
This is expected for signed-out visitors. Sign in, then return to the development page.
Signed-in download fails
Check:
- Session is still active.
- Document asset still exists.
- Browser did not block the download.
- Network request did not fail.
- User refreshed after signing in.
If the document itself appears stale or wrong, use Feedback with the page URL and document name.
Inquiries
Inquiry form is missing
Check:
- User is on a development page, not only a builder or community page.
- Development page loaded correctly.
- Inquiry section is lower on the page or in the sidebar depending on screen size.
- A grouped builder/community card was not mistaken for a specific development page.
Submission fails
| Failure | What to check |
|---|---|
| Required field error | Name, email, phone, and preferred contact method are filled. |
| Invalid email | Email format is valid. |
| Message too long | Additional comments are under 2,000 characters. |
| Spam verification failed | Retry, and check privacy/script blockers. |
| Entity not found | Refresh the development page and submit again. |
| Network error | Confirm connectivity and retry. |
If a hidden spam field is filled by a bot or aggressive autofill, Solum may return a fake success response.
Team workspaces
Team settings are missing
User likely lacks Manage team.
Owners and platform administrators can adjust access. Admins usually have Manage team, while Members and Billing users do not.
Members card is missing
User likely lacks Manage members.
Admins may manage regular members, but only owners or platform administrators should invite Admin or Billing users.
Billing card is missing
User lacks Manage billing.
Owners and Billing users receive billing access by default. Admins do not receive billing access by default.
Builder media and documents
Builder tools are missing
Check:
- Team type is Builder.
- Team is linked to a builder profile.
- User belongs to the team.
- User has Manage team or platform admin access.
- The target development belongs to the linked builder.
If the page says No builder linked, role changes will not solve the issue. The team needs builder-profile linkage.
Upload fails
| Failure | What to check |
|---|---|
| Unsupported type | Use JPEG, PNG, or WebP for images. Use PDF for documents. |
| File too large | Images must be 10 MB or smaller. PDFs must be 25 MB or smaller. |
| Collection limit | Gallery supports up to 20 images. Documents support up to 10 PDFs. |
| Upload link expired | Start the upload again. |
| Storage not configured | Environment storage settings may be missing. |
| Permission denied | Confirm Manage team and entity ownership. |
Billing and promotions
Stripe portal does not open
Check:
- User has Manage billing.
- Browser did not block a new tab.
- Network connection is working.
- Stripe session creation did not fail.
Feature this development is missing
Check:
- Team is a builder team.
- Team is linked to a builder profile.
- Development belongs to that builder.
- User has Manage billing.
- Development is not already featured.
- No active or pending promotion already exists.
- Stripe price configuration exists for monthly or quarterly duration.
Cancel promotion is missing
Cancellation appears only when an active promotion exists and the user has Manage billing. If a promotion is pending, cancelled, or expired, cancellation may not be available.
Data accuracy
Public data looks wrong
Use Feedback and include:
- Page URL.
- Incorrect field.
- Expected value.
- Source link or document, if available.
- Whether the issue affects price, availability, location, documents, media, or builder information.
Purchase-sensitive question
Always confirm with the builder or assigned follow-up contact before relying on:
- Price.
- Incentives.
- Availability.
- Deposit requirements.
- Lot premiums.
- Specifications.
- Completion timing.
- Contract terms.
Solum is a discovery and comparison product, not the final purchase record.
When to escalate
Escalate when:
- Correctly permissioned users cannot complete an available task.
- A document download fails after confirming sign-in and asset availability.
- Billing checkout or portal creation fails for a Manage billing user.
- Uploads fail with valid files, correct permissions, and configured storage.
- Public listing data is materially wrong and cannot be corrected through ordinary supported processes.
- A user sees internal or admin tools they should not see.
Include the evidence from First questions when escalating.