Update a listing's marketing details, visibility, photos, pricing, and leasing options in Aptly. Review the source of the data before editing, then check the public listing after your changes.
Before you edit
Listing information comes from the unit and, where connected, your property management software (PMS).
Check your sync settings first. Whether an Aptly edit updates your PMS depends on the integration, the field, and the enabled sync settings. PMS-managed marketing data may overwrite an Aptly edit when the integration does not support bidirectional sync for that field. Confirm which system your team uses as the source of truth before changing shared data.
Fields save automatically. Review the listing and its preview as you make changes.
1. Find and open the listing
Go to Locations → Listings. Search for the property or filter by beds, baths, price, home type, pets, or Published for Rent status. Select the listing title to open it.
Use the listing sections to review each type of information:
- General: Marketing, visibility, pricing, screening, and leasing details.
- Media: Photos, videos, and virtual tours.
- History: Recorded listing changes.
2. Update General details
Basic listing details
Review the marketing name, building type, address, region, and rental category. If the marketing name is blank, the listing uses the property address.
A building type and address are required for syndication.
Visibility and calls to action
- Published: Makes the listing eligible for the widget and enabled leasing products. Widget boards and filters, screening settings, showing settings, and syndication requirements still apply.
- Showings Enabled: Controls whether prospects can schedule tours, subject to your showing setup.
- Accepting Applications: Depends on the unit filters selected in Screening Management Settings.
- Syndicate: Includes the listing in enabled syndication feeds when the required listing and account settings are complete.
Turn Published off when the listing should no longer be available through Aptly's listing and leasing flows. Check any external marketing channels separately.
Showing details
For Aptly Access, review the showing link and any overrides for the tour calendar, tour mode, or calendar mode.
For an external provider, select the applicable Custom, Rently, or ShowMojo option and review its link.
See Set up Aptly Tours for Aptly tour setup.
Screening details
If you use Aptly Screening, the provider is set automatically. Select Custom when using another screening provider and review the application destination.
Promotional banner
Use Preview Text for the prospect-facing banner preview. Promo Detail appears when the prospect hovers over it.
Features and description
Review parking, laundry, heating, cooling, unit amenities, and the marketing description. Most of this information is initially synced from your PMS.
You can edit marketing fields in Aptly or disable marketing data sync when your team will maintain those details in Aptly. Confirm the integration's field ownership before making this change.
If your subscription includes AI Marketing Description, you can use it to revise the description. Review the result for accuracy before using it publicly.
Pets
Review Pets Allowed, Pet Policy, Pet Deposit, and Pet Restrictions. Use the available edit controls to update listing pet details, then verify the saved values. Keep the policy consistent with the Unit and your PMS; visible editing controls do not establish which system owns a synced field. If the value is replaced after a sync, ask your account team to confirm the integration's field ownership.
Pricing and availability
Review square footage, beds, baths, market rent, deposit, available date, and lease term. The lease term appears in the listing widget.
For listings that represent a range, such as a floor plan, use Use Ranges to set minimum and maximum rent, square footage, beds, and baths.
AI Agent Data
If AI Agents are enabled, add internal property notes the agent can use when speaking with prospects, such as parking instructions, pet-policy clarifications, or tour instructions.
Leasing information
- Leasing Contact: Review the synced unit contact or select another contact in your account as an override.
- Contact Us Form: Use a unit-specific form when the listing should differ from the default.
- Lease Package & Fees: Review the package from the Applicants board. Override or hide it for the listing when appropriate.
- Payment Account: Check where application payments will be sent. The default comes from Screening Management Settings and can be overridden for an individual listing.
3. Review Media
Check the virtual tour link, video URL, and images. You can upload images, reorder them, and choose a cover photo for the listing widget.
If images come from your PMS, review your integration's media-sync behavior before maintaining a separate set in Aptly.
4. Review History
Review the recorded updates to confirm what changed and when.
5. Verify the result
- Review the listing preview for accurate text, photos, price, availability, and contact details.
- Open the property widget link and check that the listing is included in the intended widget or segment.
- Check that enabled tour and application links open the intended destination.
- If the listing is syndicated, refresh the outbound listing feed using the Listings refresh control, then check the receiving site separately. A feed refresh does not mean that the receiving site has already imported the change.
Troubleshooting
The listing does not appear in the widget
Check Published, the widget's selected board, and its filter or segment. See Troubleshoot missing listings in the widget.
A syndicated listing is missing or outdated
Check the building type, address, Published, Syndicate, and leasing contact. Confirm the leasing contact selected in Syndication Settings. Refresh the outbound feed and distinguish a change in Aptly from an update already imported by the receiving site.
An edit is replaced after syncing
Check whether the field is maintained in your PMS and whether your integration supports bidirectional updates for it. Ask your account team to confirm field ownership rather than repeatedly changing the same value in both systems.
A pet policy looks wrong
Review the available pet controls on the listing, then compare the saved value with the Unit and PMS source. If values conflict or change after syncing, share the field name and conflicting values with your account team.
If you need help, include the listing, the field or action affected, the integration, and the expected and actual result.